Complete a local run

In draft mode, send media and caption only. In auto mode, every TikTok and YouTube target needs a published_targets entry from a direct upload.

POST/api/agent/runs/{id}/complete-local

Authorization

AuthorizationBearer token (ba_run_...) · headerrequired

Per-run token returned by start, valid for 6 hours and bound to one run.

AuthorizationBearer token (ba_sk_...) · headerrequired

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

Path parameters

idstringrequired

Run id

Request body

requiredapplication/json

captionstringrequired

max length 2200

titlestring

media_typestring

Allowed:imagecarouselvideo

media_urlsstring<uri>[]

max items 10

slidesSlide[]

max items 10

Show properties

Array of Slide

textstring

max length 500

urlstring<uri>required

aspect_ratiostring

default: "9:16"

published_targetsobject[]

max items 12

Show properties

Array of object

social_account_idstring<uuid>

platformstring

Allowed:tiktokyoutube

direct_upload_idstring<uuid>

metadataobject

executor_idstring

Responses

200

object

400

INVALID_RUN_OUTPUT

errorstringrequired

codestring

401

Missing, invalid, expired, or revoked API key

errorstringrequired

codestring

409

RUN_CONFLICT, AUTOMATION_PAUSED, REVISION_STALE, or AUTOMATION_REMOVED

errorstringrequired

codestring

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

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

Parameters

idpath*Run id

Bodyapplication/json

Request body

Request

curl -X POST "https://www.brainyshorts.com/api/agent/runs/string/complete-local" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "caption": "string",
  "title": "string",
  "media_type": "image",
  "media_urls": [
    "http://example.com"
  ],
  "slides": [
    {
      "text": "string",
      "url": "http://example.com",
      "aspect_ratio": "9:16"
    }
  ],
  "published_targets": [
    {
      "social_account_id": "f4777757-36aa-48ee-b520-6e818e68eb51",
      "platform": "tiktok",
      "direct_upload_id": "28819bb3-02a6-40f2-80ee-1b080beb2151"
    }
  ],
  "metadata": {},
  "executor_id": "string"
}'

const response = await fetch("https://www.brainyshorts.com/api/agent/runs/string/complete-local", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"caption\": \"string\",\n  \"title\": \"string\",\n  \"media_type\": \"image\",\n  \"media_urls\": [\n    \"http://example.com\"\n  ],\n  \"slides\": [\n    {\n      \"text\": \"string\",\n      \"url\": \"http://example.com\",\n      \"aspect_ratio\": \"9:16\"\n    }\n  ],\n  \"published_targets\": [\n    {\n      \"social_account_id\": \"f4777757-36aa-48ee-b520-6e818e68eb51\",\n      \"platform\": \"tiktok\",\n      \"direct_upload_id\": \"28819bb3-02a6-40f2-80ee-1b080beb2151\"\n    }\n  ],\n  \"metadata\": {},\n  \"executor_id\": \"string\"\n}"
});

import requests

response = requests.post(
    "https://www.brainyshorts.com/api/agent/runs/string/complete-local",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"caption\": \"string\",\n  \"title\": \"string\",\n  \"media_type\": \"image\",\n  \"media_urls\": [\n    \"http://example.com\"\n  ],\n  \"slides\": [\n    {\n      \"text\": \"string\",\n      \"url\": \"http://example.com\",\n      \"aspect_ratio\": \"9:16\"\n    }\n  ],\n  \"published_targets\": [\n    {\n      \"social_account_id\": \"f4777757-36aa-48ee-b520-6e818e68eb51\",\n      \"platform\": \"tiktok\",\n      \"direct_upload_id\": \"28819bb3-02a6-40f2-80ee-1b080beb2151\"\n    }\n  ],\n  \"metadata\": {},\n  \"executor_id\": \"string\"\n}",
)

Response

{}

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

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

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