Update or unschedule a post

Accepts a delivery id or a parent post id. Every still-scheduled delivery under the parent is updated together. status: "draft" cancels the schedule.

PATCH/api/cli/posts

Authorization

AuthorizationBearer token (ba_sk_...) · headerrequired

API key from /dashboard/api-keys. Keys expire after 365 days.

Request body

requiredapplication/json

idstringrequired

Delivery id or parent post id

statusstring

Allowed:draftscheduled

captionstring

max length 2200

scheduled_atstring<date-time>

Must be in the future. scheduled_time is accepted as an alias.

add_targetsTarget[]

max items 12

Show properties

Array of Target

social_account_idstring<uuid>required

platformPlatformrequired

Allowed:tiktokinstagramyoutubelinkedinx

settingsobject

Responses

200

post_idstring

social_postsobject[]

400

INVALID_POST_UPDATE

errorstringrequired

codestring

401

Missing, invalid, expired, or revoked API key

errorstringrequired

codestring

404

Not found

errorstringrequired

codestring

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer token (ba_sk_...)Remember on this deviceInclude my values in samples

Bodyapplication/json

Request body

Request

curl -X PATCH "https://www.brainyshorts.com/api/cli/posts" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "id": "string",
  "status": "draft",
  "caption": "string",
  "scheduled_at": "2019-08-24T14:15:22Z",
  "add_targets": [
    {
      "social_account_id": "f4777757-36aa-48ee-b520-6e818e68eb51",
      "platform": "tiktok",
      "settings": {}
    }
  ]
}'

const response = await fetch("https://www.brainyshorts.com/api/cli/posts", {
  method: "PATCH",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"id\": \"string\",\n  \"status\": \"draft\",\n  \"caption\": \"string\",\n  \"scheduled_at\": \"2019-08-24T14:15:22Z\",\n  \"add_targets\": [\n    {\n      \"social_account_id\": \"f4777757-36aa-48ee-b520-6e818e68eb51\",\n      \"platform\": \"tiktok\",\n      \"settings\": {}\n    }\n  ]\n}"
});

import requests

response = requests.patch(
    "https://www.brainyshorts.com/api/cli/posts",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"id\": \"string\",\n  \"status\": \"draft\",\n  \"caption\": \"string\",\n  \"scheduled_at\": \"2019-08-24T14:15:22Z\",\n  \"add_targets\": [\n    {\n      \"social_account_id\": \"f4777757-36aa-48ee-b520-6e818e68eb51\",\n      \"platform\": \"tiktok\",\n      \"settings\": {}\n    }\n  ]\n}",
)

Response

{
  "post_id": "string",
  "social_posts": [
    {}
  ]
}

{
  "error": "string",
  "code": "string"
}

{
  "error": "string",
  "code": "string"
}

{
  "error": "string",
  "code": "string"
}