Skip to main content

Upload History

Retrieve and manage past uploads.

List Uploads​

GET https://api.indreelforge.com/api/uploads

Returns a paginated list of all uploads for the authenticated account.

Query Parameters​

ParameterDefaultDescription
page1Page number
limit20Results per page (max 100)
profile—Filter by profile name
platform—Filter by platform (e.g. instagram)
status—Filter by status (queued, processing, done, failed)
curl \
-H 'Authorization: Apikey YOUR_API_KEY' \
'https://api.indreelforge.com/api/uploads?page=1&limit=20'

Response​

{
"status": "success",
"data": {
"uploads": [
{
"id": "upl_abc123",
"profile": "my-brand",
"title": "My Video",
"type": "video",
"platforms": ["instagram", "youtube"],
"status": "done",
"source": "api",
"platform_post_urls": {
"instagram": "https://www.instagram.com/p/abc123/",
"youtube": "https://www.youtube.com/watch?v=xyz789"
},
"created_at": "2025-06-01T10:00:00.000Z",
"completed_at": "2025-06-01T10:00:45.000Z"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 143,
"pages": 8
}
}
}

Get Upload Status​

GET https://api.indreelforge.com/api/uploads/:upload_id

Get the status and details of a specific upload.

curl \
-H 'Authorization: Apikey YOUR_API_KEY' \
https://api.indreelforge.com/api/uploads/upl_abc123

Response​

{
"status": "success",
"data": {
"id": "upl_abc123",
"profile": "my-brand",
"title": "My Video",
"type": "video",
"platforms": ["instagram", "youtube"],
"status": "done",
"platform_post_urls": {
"instagram": "https://www.instagram.com/p/abc123/",
"youtube": "https://www.youtube.com/watch?v=xyz789"
},
"created_at": "2025-06-01T10:00:00.000Z",
"completed_at": "2025-06-01T10:00:45.000Z"
}
}

Retry Failed Upload​

POST https://api.indreelforge.com/api/uploads/:upload_id/retry

Re-queues a failed upload for processing.

curl \
-H 'Authorization: Apikey YOUR_API_KEY' \
-X POST https://api.indreelforge.com/api/uploads/upl_abc123/retry

Response​

{
"status": "success",
"message": "Upload re-queued"
}

Delete Upload​

DELETE https://api.indreelforge.com/api/uploads/:upload_id

Removes an upload record from your history. Does not delete content from social platforms.

curl \
-H 'Authorization: Apikey YOUR_API_KEY' \
-X DELETE https://api.indreelforge.com/api/uploads/upl_abc123

Legacy Aliases (upload-post SDK compatibility)​

Deprecated

These endpoints are backward-compatibility aliases for users migrating from the upload-post SDK. They will be removed in a future major version. Prefer the canonical /api/uploads paths documented above.

Upload History (legacy)​

GET https://api.indreelforge.com/api/uploadposts/history

Alias for GET /api/uploads. Returns upload history in the upload-post SDK response envelope.

curl \
-H 'Authorization: Apikey YOUR_API_KEY' \
https://api.indreelforge.com/api/uploadposts/history

Upload Status by Request ID (legacy)​

GET https://api.indreelforge.com/api/uploadposts/status?request_id=REQUEST_ID

Returns upload status by request_id or job_id — the identifiers used by the upload-post SDK.

Query ParameterDescription
request_idThe request ID returned by a legacy upload-post SDK call
job_idThe job ID returned by a legacy upload-post SDK call
curl \
-H 'Authorization: Apikey YOUR_API_KEY' \
'https://api.indreelforge.com/api/uploadposts/status?request_id=REQ_ID'

Upload Status by Path ID (alternate)​

GET https://api.indreelforge.com/api/upload/:id/status

Alternate path for GET /api/uploads/:upload_id. Both :id and :upload_id are accepted by the backend — use the canonical /api/uploads/:upload_id form in new integrations.