Cue
API ReferencePosts

List posts

Retrieve all posts for your account, optionally filtered by profile or status.

GET
/posts

Authorization

bearerAuth
AuthorizationBearer <token>

API keys start with cue_sk_ prefix. Get your key from the Cue dashboard.

Example: cue_sk_abc123def456ghi789jkl012mno345pqr678stu901vwx234

In: header

Query Parameters

profile_id?string

Filter posts by profile ID

status?string

Filter posts by status

Value in"draft" | "scheduled" | "publishing" | "published" | "failed"

Response Body

application/json

application/json

application/json

curl -X GET "https://api.oncue.so/v1/posts"
{
  "data": [
    {
      "id": "pst_r3v8n2xk5qmj",
      "profileId": "prf_h7k2m9xp4qnj",
      "content": "Excited to announce our new feature launch! Check it out at oncue.so",
      "status": "published",
      "scheduledAt": null,
      "createdAt": "2025-01-15T10:00:00Z",
      "updatedAt": "2025-01-15T10:01:00Z",
      "platforms": [
        {
          "socialAccountId": "sac_p4n7k2m9xqhj",
          "platform": "bluesky",
          "platformUsername": "mybrand.bsky.social",
          "platformAvatar": "https://cdn.bsky.app/avatar.jpg",
          "status": "published",
          "errorMessage": null
        }
      ],
      "media": []
    }
  ]
}
{
  "error": "Unauthorized"
}
{
  "error": "Profile not found"
}