> ## Documentation Index > Fetch the complete documentation index at: https://docs.social-api.ai/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > Base URL: https://api.social-api.ai/v1. Send your API key in the Authorization header: Authorization: Bearer . > Every error response from /v1 is JSON: { "error": { "code", "message", "meta" (optional) }, "request_id" }. Branch on error.code; use error.message only for logs. > A 429 response carries a Retry-After header, in seconds, when the limit has a known wait. Authenticated responses can carry X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset for the per-minute request budget your SocialAPI account shares across every API key (see /guides/rate-limits). > Paginated list endpoints return next_cursor, at the top level or inside pagination (see /guides/pagination). Pass it as the cursor query parameter to get the next page. An absent or empty next_cursor means you have the last page. > Treat every ID as an opaque string: do not parse it or assume a format. > Support differs by platform and by operation. Check /platforms/overview before assuming an operation works on a platform. An unsupported operation returns 501 with error.code resource.not_supported. # Update a Queue > Updates the fields you send and keeps the rest. slots replaces the whole list. Set active to false to pause the Queue: posts already in it keep their times, and no new post can join it. is_default can only be set to true, which makes this Queue the Brand's default; to change the default, set another Queue's is_default to true. Posts already queued keep their times unless you send reshuffle_existing: true, which moves them onto the new slots in their current order and returns reshuffled_count. ## OpenAPI ````yaml /api-reference/openapi.json patch /queues/{qid} openapi: 3.0.0 info: description: >- Unified social media inbox API. Read and respond to comments, DMs, reviews, and mentions across Instagram, Facebook, Threads, Google Business Profile, TikTok, LinkedIn, and YouTube through a single REST API. X/Twitter and Trustpilot coming soon. title: SocialAPI.AI contact: name: SocialAPI.AI Support email: support@social-api.ai license: name: MIT version: '1.0' servers: - url: https://api.social-api.ai/v1 security: [] paths: /queues/{qid}: patch: tags: - Queues summary: Update a Queue description: >- Updates the fields you send and keeps the rest. slots replaces the whole list. Set active to false to pause the Queue: posts already in it keep their times, and no new post can join it. is_default can only be set to true, which makes this Queue the Brand's default; to change the default, set another Queue's is_default to true. Posts already queued keep their times unless you send reshuffle_existing: true, which moves them onto the new slots in their current order and returns reshuffled_count. parameters: - example: que_01J9Z8Y7X6W5V4T3S2R1Q0P9N8 description: Queue ID name: qid in: path required: true schema: type: string requestBody: content: application/json: schema: $ref: >- #/components/schemas/social-api_ai_core_api_service.UpdateQueueParams description: Fields to change required: true responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/api_endpoints.UpdateQueueResponse' '400': description: >- Invalid timezone, slots, name or is_default (validation.field_invalid) content: application/json: schema: $ref: '#/components/schemas/api_endpoints.ErrorResponse' '401': description: Invalid or missing API key content: application/json: schema: $ref: '#/components/schemas/api_endpoints.ErrorResponse' '403': description: The key's scopes do not include posts:write content: application/json: schema: $ref: '#/components/schemas/api_endpoints.ErrorResponse' '404': description: Queue not found (queue.not_found) content: application/json: schema: $ref: '#/components/schemas/api_endpoints.ErrorResponse' '409': description: >- reshuffle_existing found no free time for a post within 366 days (queue.full) content: application/json: schema: $ref: '#/components/schemas/api_endpoints.ErrorResponse' security: - BearerAuth: [] components: schemas: social-api_ai_core_api_service.UpdateQueueParams: type: object properties: active: description: False pauses the Queue, true resumes it. type: boolean example: true is_default: description: 'Only true is accepted: it makes this the Brand''s default Queue.' type: boolean example: true name: description: New name. type: string example: Evenings reshuffle_existing: description: >- Set true to move the Queue's posts onto the new slots, in their current order. The response then carries reshuffled_count. type: boolean example: false slots: description: >- Weekly posting times. Replaces the whole list when sent; omit to keep the current list. type: array items: $ref: '#/components/schemas/social-api_ai_core_api_service.Slot' timezone: description: New IANA timezone. type: string example: Europe/Paris api_endpoints.UpdateQueueResponse: type: object properties: active: description: 'False when the Queue is paused: no new post can join it.' type: boolean example: true brand_id: description: ID of the Brand the Queue belongs to. type: string created_at: description: When the Queue was created. type: string id: description: Queue ID. type: string example: que_01J9Z8Y7X6W5V4T3S2R1Q0P9N8 is_default: description: >- True for the Brand's default Queue, the one queue_id "default" refers to. type: boolean example: true name: description: Queue name. type: string example: Evenings reshuffled_count: description: >- Number of queued posts moved to the new times. Present only when the request sent reshuffle_existing: true. type: integer slots: description: Weekly posting times, sorted by day (Monday first) then time. type: array items: $ref: '#/components/schemas/social-api_ai_core_api_service.Slot' timezone: description: IANA timezone the slots are expressed in. type: string example: Europe/Paris updated_at: description: When the Queue was last changed. type: string api_endpoints.ErrorResponse: type: object properties: error: $ref: '#/components/schemas/api_endpoints.ErrorBody' request_id: description: >- RequestID matches the X-Request-ID response header. Include it when contacting support. type: string example: 01HZ9X3Q4R5M6N7P8V2K0W1J social-api_ai_core_api_service.Slot: type: object properties: day: description: Lowercase English weekday name. type: string enum: - monday - tuesday - wednesday - thursday - friday - saturday - sunday example: tuesday time: description: Time of day as HH:MM, 24-hour, in the Queue's timezone. type: string example: '19:00' api_endpoints.ErrorBody: type: object properties: code: type: string example: resource.not_found message: type: string example: Account not found meta: type: object additionalProperties: {} securitySchemes: BearerAuth: description: >- Prefix your API key with "Bearer ". Example: `Authorization: Bearer sapi_key_...` type: apiKey name: Authorization in: header ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.