Skip to main content

Upload History

Retrieve a paginated list of your past uploads across platforms.

Endpoint​

GET /api/uploadposts/history

Headers​

NameValueDescription
AuthorizationApikey your-api-keyRequired.

Query Parameters​

NameTypeRequiredDefaultAllowedDescription
pageIntegerNo1>= 1Page number
limitIntegerNo1010, 20, 50, 100Page size

Responses​

  • 200 OK
    • history: array of history items (most recent first)
    • total: total number of records for the user
    • page: requested page
    • limit: requested limit
  • 400 Bad Request: { "error": "Invalid page" } or { "error": "Invalid limit" }
  • 401 Unauthorized: { "success": false, "message": "Invalid or expired token" }
  • 500 Internal Server Error: { "error": "Failed to retrieve upload history", "details": "..." }

History Item Schema​

Typical fields (not all fields are guaranteed on every record):

  • user_email: string
  • profile_username: string
  • platform: string (e.g., tiktok, instagram, linkedin, youtube, facebook, x, threads, pinterest)
  • media_type: string (video | photo | text)
  • upload_timestamp: string (ISO-8601)
  • success: boolean
  • platform_post_id: string | array | null
  • post_url: string | null (present when success is true)
  • error_message: string | null
  • media_size_bytes: number | null
  • post_title: string | null
  • post_caption: string | null
  • is_async: boolean | null
  • job_id: string | null (present when the upload originated from a scheduled job)
  • dashboard: any | null
  • video_was_transcoded: boolean | null
  • changes: object | null
  • prevalidation_metadata: object | null
  • request_id: string | null
  • request_total_platforms: number | null

Note: When you schedule a post, the resulting history items will include job_id. Use this to correlate the scheduled job with the eventual publish record in history.

Example Request​

curl -X GET "https://api.upload-post.com/api/uploadposts/history?page=1&limit=20" \
  -H "Authorization: Apikey your-api-key"

Example 200 Response (truncated)​

{
  "history": [
    {
      "user_email": "[email protected]",
      "profile_username": "profile_username",
      "platform": "instagram",
      "media_type": "video",
      "upload_timestamp": "2025-09-04T10:22:33.123Z",
      "success": true,
      "platform_post_id": "1789654321",
      "post_url": "https://instagram.com/p/abc123",
      "media_size_bytes": 12345678,
      "post_title": "Title",
      "post_caption": "Description",
      "is_async": false,
      "job_id": "a1b2c3d4e5f67890a1b2c3d4e5f67890",
      "dashboard": true,
      "request_id": "req_123",
      "request_total_platforms": 3
    }
  ],
  "total": 42,
  "page": 1,
  "limit": 20
}

See also​