Cue
API ReferencePosts

Publish a post immediately

Queue a draft or scheduled post for immediate publishing.

POST
/posts/{id}/publish

Authorization

bearerAuth
AuthorizationBearer <token>

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

Example: cue_sk_abc123def456ghi789jkl012mno345pqr678stu901vwx234

In: header

Path Parameters

id*string

Post ID

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://api.oncue.so/v1/posts/pst_r3v8n2xk5qmj/publish"
{
  "data": {
    "id": "pst_r3v8n2xk5qmj",
    "profileId": "prf_h7k2m9xp4qnj",
    "content": "Publishing now!",
    "status": "queued",
    "scheduledAt": null,
    "createdAt": "2025-01-15T10:00:00Z",
    "updatedAt": "2025-01-15T12:00:00Z"
  },
  "message": "Post queued for publishing to 1 platform(s)"
}

{
  "error": "Cannot publish a post with status: published"
}

{
  "error": "Unauthorized"
}
{
  "error": "Post not found"
}
{
  "error": "Queue not configured"
}