Cue
API ReferencePosts

Update a post

Update a draft or scheduled post. Cannot update posts that are queued, publishing, or published.

Setting scheduledAt to a datetime will change status to scheduled. Setting scheduledAt to null will change status to draft.

PATCH
/posts/{id}

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

Request Body

application/json

platforms?

Per-account content mapping. Keys are social account IDs, values contain the content items.

Single item = single post. Multiple items = thread (requires Growth plan or above).

This format allows different content per platform, respecting each platform's character limits and style.

scheduledAt?string

New scheduled time, or null to unschedule

Formatdate-time

Response Body

application/json

application/json

application/json

application/json

curl -X PATCH "https://api.oncue.so/v1/posts/pst_r3v8n2xk5qmj" \  -H "Content-Type: application/json" \  -d '{    "content": "Updated content with new information",    "scheduledAt": "2025-01-25T14:00:00-05:00"  }'
{
  "data": {
    "id": "pst_r3v8n2xk5qmj",
    "profileId": "prf_h7k2m9xp4qnj",
    "content": "Updated content with new information",
    "status": "scheduled",
    "scheduledAt": "2025-01-25T14:00:00-05:00",
    "createdAt": "2025-01-15T10:00:00Z",
    "updatedAt": "2025-01-15T11:30:00Z"
  }
}
{
  "error": "Cannot update a post that is already being published"
}
{
  "error": "Unauthorized"
}
{
  "error": "Post not found"
}