Upload Post

Overview

This node interacts with the Upload-Post API to manage social media content uploads and monitor their status. Specifically, the "Status & History" resource with the "Get Upload Status" operation allows users to query the status of an asynchronous upload by providing a request ID. This is useful when uploads are processed asynchronously, enabling workflows to check if an upload has completed, failed, or is still in progress.

Practical scenarios include:

• After initiating an asynchronous photo, video, or text post upload, use this node to poll the upload status.
• Integrate into automation workflows that need to wait for confirmation before proceeding.
• Monitor upload progress and handle errors or retries based on the returned status.

Properties

Output

The node outputs a JSON object representing the current status of the upload request identified by the provided Request ID. The structure includes fields such as:

• success: Boolean indicating if the status retrieval was successful.
• status: Current status of the upload (e.g., "success", "completed", "failed", "error").
• message: Optional message describing the status or error.
• request_id: The same request ID queried.

If the upload was initiated asynchronously and the user enabled waiting for completion, the node will poll the status endpoint until the upload completes or times out, returning the final status.

No binary data output is produced by this operation.

Dependencies

• Requires an API key credential for the Upload-Post API.
• The node makes HTTP requests to https://api.upload-post.com/api/uploadposts/status.
• No additional environment variables or external services are required beyond the API key.

Troubleshooting

• Common issues:

  • Providing an invalid or expired request_id will result in failure to retrieve status.
  • Network connectivity problems can cause request failures.
  • If polling is enabled, a timeout may occur if the upload takes too long.

• Error messages:

  • "Polling timed out": The node waited longer than the configured timeout without receiving a terminal status. Increase the timeout or check the upload process.
  • API errors related to authorization indicate missing or incorrect API key credentials.
  • Warnings about missing binary data do not apply to this operation but may appear if other operations are used incorrectly.

Links and References

• Upload-Post API Documentation (general reference for API endpoints)
• n8n Documentation for general usage of HTTP request nodes and credentials management