Posts

List posts

Your workspace's posts, newest first.

get/posts

Request

  • Base URL: https://api.deploy.social/v1
  • URL: https://api.deploy.social/v1/posts
  • Auth: HTTP bearer

Query parameters

limitinteger

How many to return, 1 to 100. Defaults to 25.

Example:25
cursorstring

The next_cursor from the previous page.

statusstring

Only these statuses, comma-separated.

Example:scheduled,failed
media_idstring

Only posts of this video.

Example:media_cmf3k0m2b0000ab12cd34ef56
created_via'app' | 'mobile' | 'api' | 'mcp'

Only posts made here.

created_afterstring date-time

Only posts created after this time.

created_beforestring date-time

Only posts created before this time.

Response

A page of posts.

next_cursorstring nullable required

Pass as cursor for the next page. null on the last page.

Example response

{
  "data": [
    {
      "id": "post_cmf3k2x9a0001ab12cd34ef56",
      "status": "scheduled",
      "kind": "video",
      "media_id": "media_cmf3k0m2b0000ab12cd34ef56",
      "media": [
        {
          "media_id": "media_cmf3k0m2b0000ab12cd34ef56"
        }
      ],
      "caption": "A quick look around the studio.",
      "scheduled_at": "2026-10-01T15:00:00.000Z",
      "created_via": "api",
      "created_at": "2026-10-01T15:00:00.000Z",
      "updated_at": "2026-10-01T15:00:00.000Z",
      "destinations": [
        {
          "destination_id": "dest_cmf3k1q7z0000ab12cd34ef56",
          "platform": "youtube",
          "handle": "northsidestudio",
          "options": {
            "privacy": "public"
          },
          "status": "published",
          "progress": {
            "phase": "uploading",
            "percent": 40
          },
          "published_at": "2026-10-01T15:00:00.000Z"
        }
      ],
      "issues": [
        {
          "path": "destinations[1].options.privacy",
          "code": "required",
          "message": "TikTok needs you to choose who can watch."
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.