API reference · Account
Post a share to the person's own account
POST/api/studio/publishSigned in session
Sends one of the person's own live shares to a linked account: YouTube by its resumable upload (privacy private, unlisted or public; private when unsaid), TikTok by its direct post after reading the account's creator info (privacy must be one of the account's own choices; comments, Duet and Stitch stay off unless allowed and the account allows them), Instagram as a Reel it fetches from the share's own public link. Nothing is charged. Each platform is offered only while the operator set its app's keys, with stored media on and a pinned session secret; off, its doors are the unknown 404. The signed in account; same origin for a write.
Request body
application/json, required
| Field | Type | What it is |
|---|---|---|
| share_idrequired | string | |
| platformrequired | string | One of "tiktok", "youtube", "instagram". |
| title | string | At most 2200 characters. |
| privacy | string | |
| allow | object | |
| allow. | boolean | |
| allow. | boolean | |
| allow. | boolean |
Example
{
"share_id": "string",
"platform": "tiktok"
}Answer 200
Sent, processing, published, or failed with the platform's words.
| Field | Type | What it is |
|---|---|---|
| id | string | |
| share_id | string | |
| platform | string | One of "tiktok", "youtube", "instagram". |
| state | string | One of "sending", "processing", "published", "failed". |
| url | string or null | The post on the platform, once it says. |
| privacy | string or null | |
| error | string or null | The platform's own short words. |
| created_at | integer |
Errors
- 400OpenAI shaped error.
- 401OpenAI shaped error.
- 403OpenAI shaped error.
- 404OpenAI shaped error.
- 409OpenAI shaped error.
- 429OpenAI shaped error.
- 502OpenAI shaped error.
Every error answers in one shape, with its type, code and the field it names. The whole list is in the docs' Errors section.