Skip to main content
Category QueueVersion: v3

Update queue settings or status

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

Updates queue status (active/paused/deleted), time slots, or skip dates.

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

Body

locationIdstringrequired

Location ID

Example:609e126a1c4ae1001291e1b5
skipLegacyWatermarkboolean

Skip legacy watermark cleanup when rescheduling posts

Example:false
statusstring

Status of the Queue

Available optionsactivepauseddeleted
Example:paused
skipDateTimestring

Skip Date Time in ISO format

Example:2023-10-05T14:48:00.000Z
timeSlotsobject[]

Time slots defining when posts should be published

Example
[
  {
    "dayOfWeek": 1,
    "time": "09:00"
  },
  {
    "dayOfWeek": 3,
    "time": "14:30"
  }
]
enableFuturePostsboolean

Enable posting future content. Automatically Queue any New Posts Created in this Category.

Example:true
prioritizeNewContentboolean

Prioritize new content over older content. When true, new items added via directToQueue will be placed at the top of the queue.

Example:false

Response

Queue updated successfully.

successbooleanrequired

Success or Failure

Example:true
statusCodenumberrequired

Status Code

Example:200
resultsobjectrequired

Response payload

traceIdstring

Trace ID for debugging

Example:TRACE-abc123-def456