Configure autopilot

curl --request PUT \
  --url https://api.sigmora.org/v1/autopilots/{brandId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "enabled": true,
  "mode": "review_first",
  "runIntervalMinutes": 1440,
  "timezone": "Africa/Nairobi",
  "quietHours": {
    "start": "22:00",
    "end": "07:00"
  },
  "caps": {
    "maxVideosPerDay": 1,
    "maxPostsPerDay": 2,
    "maxSpendUsdPerRun": 5
  },
  "destinations": [
    {
      "platform": "youtube",
      "productId": "pocketledger",
      "productTargetId": "pt_youtube_main"
    }
  ],
  "targetSeconds": 45
}
'

import requests

url = "https://api.sigmora.org/v1/autopilots/{brandId}"

payload = {
    "enabled": True,
    "mode": "review_first",
    "runIntervalMinutes": 1440,
    "timezone": "Africa/Nairobi",
    "quietHours": {
        "start": "22:00",
        "end": "07:00"
    },
    "caps": {
        "maxVideosPerDay": 1,
        "maxPostsPerDay": 2,
        "maxSpendUsdPerRun": 5
    },
    "destinations": [
        {
            "platform": "youtube",
            "productId": "pocketledger",
            "productTargetId": "pt_youtube_main"
        }
    ],
    "targetSeconds": 45
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    enabled: true,
    mode: 'review_first',
    runIntervalMinutes: 1440,
    timezone: 'Africa/Nairobi',
    quietHours: {start: '22:00', end: '07:00'},
    caps: {maxVideosPerDay: 1, maxPostsPerDay: 2, maxSpendUsdPerRun: 5},
    destinations: [
      {
        platform: 'youtube',
        productId: 'pocketledger',
        productTargetId: 'pt_youtube_main'
      }
    ],
    targetSeconds: 45
  })
};

fetch('https://api.sigmora.org/v1/autopilots/{brandId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "autopilot": {
    "id": "<string>",
    "contentBrandId": "<string>",
    "enabled": true,
    "mode": "draft_only",
    "runIntervalMinutes": 0,
    "timezone": "<string>",
    "quietHours": {
      "start": "<string>",
      "end": "<string>"
    },
    "destinations": [
      {
        "platform": "whatsapp",
        "productId": "<string>",
        "productTargetId": "<string>",
        "channelRef": "<string>"
      }
    ],
    "sourceClipIds": [
      "<string>"
    ],
    "targetSeconds": 0,
    "shortsCount": 0,
    "trendWindowHours": 0,
    "minTrendScore": 123,
    "lastRunAt": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "creditQuote": {
      "currency": "credits",
      "totalCredits": 4503599627370495,
      "lines": [
        {
          "phase": "content",
          "step": "<string>",
          "operation": "<string>",
          "unitCredits": 4503599627370495,
          "quantity": 4503599627370495,
          "credits": 4503599627370495
        }
      ]
    }
  },
  "creditQuote": {
    "currency": "credits",
    "totalCredits": 4503599627370495,
    "lines": [
      {
        "phase": "content",
        "step": "<string>",
        "operation": "<string>",
        "unitCredits": 4503599627370495,
        "quantity": 4503599627370495,
        "credits": 4503599627370495
      }
    ]
  }
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

Configure autopilot

Create, configure, pause, or resume a Brand autopilot. draft_only asks before rendering; review_first renders but asks before distribution; full_auto runs through scheduling. Caps, quiet hours and approval SLA are enforced by the same step runner used by first-party agent workflows. While the workspace Governance settings lock agent configuration, only a workspace owner (or an admin of its organization) may create, configure or resume an autopilot; any other key gets 403 forbidden. Pausing an autopilot that already exists (a body of exactly {"enabled": false}) stays open to editors.

PUT

autopilots

{brandId}

Configure autopilot

curl --request PUT \
  --url https://api.sigmora.org/v1/autopilots/{brandId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "enabled": true,
  "mode": "review_first",
  "runIntervalMinutes": 1440,
  "timezone": "Africa/Nairobi",
  "quietHours": {
    "start": "22:00",
    "end": "07:00"
  },
  "caps": {
    "maxVideosPerDay": 1,
    "maxPostsPerDay": 2,
    "maxSpendUsdPerRun": 5
  },
  "destinations": [
    {
      "platform": "youtube",
      "productId": "pocketledger",
      "productTargetId": "pt_youtube_main"
    }
  ],
  "targetSeconds": 45
}
'

import requests

url = "https://api.sigmora.org/v1/autopilots/{brandId}"

payload = {
    "enabled": True,
    "mode": "review_first",
    "runIntervalMinutes": 1440,
    "timezone": "Africa/Nairobi",
    "quietHours": {
        "start": "22:00",
        "end": "07:00"
    },
    "caps": {
        "maxVideosPerDay": 1,
        "maxPostsPerDay": 2,
        "maxSpendUsdPerRun": 5
    },
    "destinations": [
        {
            "platform": "youtube",
            "productId": "pocketledger",
            "productTargetId": "pt_youtube_main"
        }
    ],
    "targetSeconds": 45
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    enabled: true,
    mode: 'review_first',
    runIntervalMinutes: 1440,
    timezone: 'Africa/Nairobi',
    quietHours: {start: '22:00', end: '07:00'},
    caps: {maxVideosPerDay: 1, maxPostsPerDay: 2, maxSpendUsdPerRun: 5},
    destinations: [
      {
        platform: 'youtube',
        productId: 'pocketledger',
        productTargetId: 'pt_youtube_main'
      }
    ],
    targetSeconds: 45
  })
};

fetch('https://api.sigmora.org/v1/autopilots/{brandId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "autopilot": {
    "id": "<string>",
    "contentBrandId": "<string>",
    "enabled": true,
    "mode": "draft_only",
    "runIntervalMinutes": 0,
    "timezone": "<string>",
    "quietHours": {
      "start": "<string>",
      "end": "<string>"
    },
    "destinations": [
      {
        "platform": "whatsapp",
        "productId": "<string>",
        "productTargetId": "<string>",
        "channelRef": "<string>"
      }
    ],
    "sourceClipIds": [
      "<string>"
    ],
    "targetSeconds": 0,
    "shortsCount": 0,
    "trendWindowHours": 0,
    "minTrendScore": 123,
    "lastRunAt": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "creditQuote": {
      "currency": "credits",
      "totalCredits": 4503599627370495,
      "lines": [
        {
          "phase": "content",
          "step": "<string>",
          "operation": "<string>",
          "unitCredits": 4503599627370495,
          "quantity": 4503599627370495,
          "credits": 4503599627370495
        }
      ]
    }
  },
  "creditQuote": {
    "currency": "credits",
    "totalCredits": 4503599627370495,
    "lines": [
      {
        "phase": "content",
        "step": "<string>",
        "operation": "<string>",
        "unitCredits": 4503599627370495,
        "quantity": 4503599627370495,
        "credits": 4503599627370495
      }
    ]
  }
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization

string

header

required

A workspace API key.

Path Parameters

brandId

string

required

The Brand this autopilot drives. GET /v1/brands lists them.

Required string length: 1 - 200

Example:

"brd_4b81"

Body

application/json

enabled

boolean

Whether this Brand's autopilot may run, scheduled or manual. false pauses it without deleting the configuration: scheduled runs stop, and POST /v1/autopilot-runs and the approval and retry of its runs answer 409 conflict until it is true again. Omitted on the first save it defaults to false; omitted later, the saved value is kept.

mode

enum<string>

draft_only asks before rendering; review_first asks before publishing; full_auto schedules without the normal approval checkpoint.

Available options:

draft_only,

review_first,

full_auto

runIntervalMinutes

integer

Minutes between eligible scheduled runs. 60 to 43,200.

Required range: 60 <= x <= 43200

timezone

string

IANA timezone used for schedules and quiet hours.

Required string length: 1 - 100

Example:

"Africa/Nairobi"

quietHours

object | null

Local time window during which publishing waits. Send null to remove quiet hours.

Show child attributes

approvalSla

object

How long a pending human approval may wait and what happens next. A sent approvalSla replaces the saved one as a whole; omit it to keep the saved one.

Show child attributes

caps

object

Safety and spend limits. A zero count disables that activity. Sent caps replace the saved caps; an omitted per-day cap means its default (3 videos, 12 posts per day). Omitting caps keeps the saved caps, or 3 videos, 12 posts and 25 USD per run on a new autopilot.

Show child attributes

destinations

object[]

Where finished content should be published. An empty list generates the asset but does not publish it.

Maximum array length: 30

Show child attributes

sourceClipIds

string[]

Ids of workspace source clips to edit: the contentId of each asset from GET /v1/assets. Omit to generate a new narrated video.

Maximum array length: 100

Required string length: 1 - 300

targetSeconds

integer

Target video length in seconds. 10 to 600.

Required range: 10 <= x <= 600

shortsCount

integer

With sourceClipIds: how many vertical shorts to cut beside the long video, each with burned captions and its own titles and description. 0 to 10; omitted means 3 on a new autopilot and keeps the saved value otherwise. Each output (the long video and every short) is one footage-edit unit, the same price as POST /v1/video/edit; a short that is not delivered is refunded at settlement. A source longer than 20 minutes adds one unit per started 20 minutes beyond the first, from the length the edit measures, charged when the run settles.

Required range: 0 <= x <= 10

trendWindowHours

integer

How many hours of observed trends the run may consider. 1 to 720.

Required range: 1 <= x <= 720

minTrendScore

number

Minimum trend score eligible for automatic selection. 0 to 100.

Required range: 0 <= x <= 100

Response

Success.

success

boolean

required

autopilot

object

required

Show child attributes

creditQuote

object

required

Show child attributes

{key}

any

Meta

Projects

Sessions

Assets

Jobs

Text

Video

UGC

Editing

3D

Image

Audio

Publishing

Webhooks

Workflows

Agents

Research

Themes

Signals

Discovery

Watchlist

Performance

Autopilot

Campaigns

Brands

Products

Configure autopilot

Authorizations

Path Parameters

Body

Response