Skip to main content
Category QueueVersion: v3

Update an item in a queue

PUT/social-media-posting/category/queues/{queueId}/items/{itemId}

Updates the content or variations of a specific item within a category queue.

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your access token.

Scope:socialplanner/category.write
Auth methods:OAuthPrivate Integration
Token type:Sub-Account Token

Request​

Headers

Versionstringrequired

API Version

Available optionsv3
Example:v3

Path Parameters

queueIdstringrequired

Category queue ID

Example:507f1f77bcf86cd799439011
itemIdstringrequired

Queue item ID

Example:507f1f77bcf86cd799439011

Body

locationIdstringrequired

Location ID

Example:609e126a1c4ae1001291e1b5
sessionIdstring

Edit session ID

Example:60af88475f1b2c001f5d5f4b
modifiedPostPayloadobject

Modifications to the original post

Example
{
  "summary": "Updated queued post content",
  "media": []
}
newOrderobject

New order value or position keyword (cyclic-aware). Accepts:

  • A number: explicit order value calculated by FE as midpoint between adjacent items
  • "top": place at cyclic top (first to be scheduled next)
  • "bottom": place at cyclic bottom (last to be scheduled)

For positions between items, FE calculates: Math.floor((prevItem.order + nextItem.order) / 2)

Example:top
variationsobject[]

Variations

Example
[
  {
    "content": "Try this variation",
    "mentions": [],
    "ogTags": {
      "metaLink": "https://example.com"
    }
  }
]
primaryImagestring

Primary media URL (image)

Example:http://example.com/media.png

Response

The queue item has been successfully updated.

successbooleanrequired

Success or Failure

Example:true
statusCodenumberrequired

Status Code

Example:200
resultsobjectrequired

Response payload

traceIdstring

Trace ID for debugging

Example:TRACE-abc123-def456