curl --request PATCH \
--url https://api.social-api.ai/v1/queues/{qid} \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"active": true,
"is_default": true,
"name": "Evenings",
"reshuffle_existing": false,
"slots": [
{
"day": "tuesday",
"time": "19:00"
}
],
"timezone": "Europe/Paris"
}
'const options = {
method: 'PATCH',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
active: true,
is_default: true,
name: 'Evenings',
reshuffle_existing: false,
slots: [{day: 'tuesday', time: '19:00'}],
timezone: 'Europe/Paris'
})
};
fetch('https://api.social-api.ai/v1/queues/{qid}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.social-api.ai/v1/queues/{qid}"
payload = {
"active": True,
"is_default": True,
"name": "Evenings",
"reshuffle_existing": False,
"slots": [
{
"day": "tuesday",
"time": "19:00"
}
],
"timezone": "Europe/Paris"
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text){
"active": true,
"brand_id": "<string>",
"created_at": "<string>",
"id": "que_01J9Z8Y7X6W5V4T3S2R1Q0P9N8",
"is_default": true,
"name": "Evenings",
"reshuffled_count": 123,
"slots": [
{
"day": "tuesday",
"time": "19:00"
}
],
"timezone": "Europe/Paris",
"updated_at": "<string>"
}{
"error": {
"code": "resource.not_found",
"message": "Account not found",
"meta": {}
},
"request_id": "01HZ9X3Q4R5M6N7P8V2K0W1J"
}{
"error": {
"code": "resource.not_found",
"message": "Account not found",
"meta": {}
},
"request_id": "01HZ9X3Q4R5M6N7P8V2K0W1J"
}{
"error": {
"code": "resource.not_found",
"message": "Account not found",
"meta": {}
},
"request_id": "01HZ9X3Q4R5M6N7P8V2K0W1J"
}{
"error": {
"code": "resource.not_found",
"message": "Account not found",
"meta": {}
},
"request_id": "01HZ9X3Q4R5M6N7P8V2K0W1J"
}{
"error": {
"code": "resource.not_found",
"message": "Account not found",
"meta": {}
},
"request_id": "01HZ9X3Q4R5M6N7P8V2K0W1J"
}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.
curl --request PATCH \
--url https://api.social-api.ai/v1/queues/{qid} \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"active": true,
"is_default": true,
"name": "Evenings",
"reshuffle_existing": false,
"slots": [
{
"day": "tuesday",
"time": "19:00"
}
],
"timezone": "Europe/Paris"
}
'const options = {
method: 'PATCH',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
active: true,
is_default: true,
name: 'Evenings',
reshuffle_existing: false,
slots: [{day: 'tuesday', time: '19:00'}],
timezone: 'Europe/Paris'
})
};
fetch('https://api.social-api.ai/v1/queues/{qid}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.social-api.ai/v1/queues/{qid}"
payload = {
"active": True,
"is_default": True,
"name": "Evenings",
"reshuffle_existing": False,
"slots": [
{
"day": "tuesday",
"time": "19:00"
}
],
"timezone": "Europe/Paris"
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text){
"active": true,
"brand_id": "<string>",
"created_at": "<string>",
"id": "que_01J9Z8Y7X6W5V4T3S2R1Q0P9N8",
"is_default": true,
"name": "Evenings",
"reshuffled_count": 123,
"slots": [
{
"day": "tuesday",
"time": "19:00"
}
],
"timezone": "Europe/Paris",
"updated_at": "<string>"
}{
"error": {
"code": "resource.not_found",
"message": "Account not found",
"meta": {}
},
"request_id": "01HZ9X3Q4R5M6N7P8V2K0W1J"
}{
"error": {
"code": "resource.not_found",
"message": "Account not found",
"meta": {}
},
"request_id": "01HZ9X3Q4R5M6N7P8V2K0W1J"
}{
"error": {
"code": "resource.not_found",
"message": "Account not found",
"meta": {}
},
"request_id": "01HZ9X3Q4R5M6N7P8V2K0W1J"
}{
"error": {
"code": "resource.not_found",
"message": "Account not found",
"meta": {}
},
"request_id": "01HZ9X3Q4R5M6N7P8V2K0W1J"
}{
"error": {
"code": "resource.not_found",
"message": "Account not found",
"meta": {}
},
"request_id": "01HZ9X3Q4R5M6N7P8V2K0W1J"
}Authorizations
Prefix your API key with "Bearer ". Example: Authorization: Bearer sapi_key_...
Path Parameters
Queue ID
Body
Fields to change
False pauses the Queue, true resumes it.
true
Only true is accepted: it makes this the Brand's default Queue.
true
New name.
"Evenings"
Set true to move the Queue's posts onto the new slots, in their current order. The response then carries reshuffled_count.
false
Weekly posting times. Replaces the whole list when sent; omit to keep the current list.
Show child attributes
Show child attributes
New IANA timezone.
"Europe/Paris"
Response
OK
False when the Queue is paused: no new post can join it.
true
ID of the Brand the Queue belongs to.
When the Queue was created.
Queue ID.
"que_01J9Z8Y7X6W5V4T3S2R1Q0P9N8"
True for the Brand's default Queue, the one queue_id "default" refers to.
true
Queue name.
"Evenings"
Number of queued posts moved to the new times. Present only when the request sent reshuffle_existing: true.
Weekly posting times, sorted by day (Monday first) then time.
Show child attributes
Show child attributes
IANA timezone the slots are expressed in.
"Europe/Paris"
When the Queue was last changed.