The named destinations in this workspace and the social accounts connected to each. Unpaginated: a workspace holds a handful at most.
Pass ?refresh=true to re-read the connected accounts upstream before
answering. That is slower, and never fails the request: if the accounts
cannot be re-read, the cached ones are returned.
Authorization
bearerAuth An API key created under Settings > API & Webhooks. Keys start with sf_live_.
In: header
Query Parameters
Re-sync the connected accounts before answering.
Value in
- "true"
- "1"
Response Body
application/json
application/json
curl -X GET "https://example.com/profiles"{ "data": [ { "id": "pR4kM8xT2vQ6nL9wz", "name": "Acme brand", "description": "Main brand accounts", "color": "#0A66C2", "isDefault": true, "createdAt": "2026-05-14T08:31:00.000Z", "accounts": [ { "id": "acc_tt_01", "platform": "tiktok", "username": "acmehq", "displayName": "Acme", "pictureUrl": "https://cdn.shortfast.com/uploads/avatars/acmehq.jpg" }, { "id": "acc_yt_01", "platform": "youtube", "username": "@acme", "displayName": "Acme Studio", "pictureUrl": null } ] } ]}List publishable platforms GET
The platform keys a profile can publish to. These are the values accepted by `platforms` on a publish and on an automation's destination. Static and workspace-independent.
Publish a video now POST
Posts the rendered video to the connected social accounts. Omit `profileId` and `platforms` to use the video's own destination (a clip inherits its blueprint's). Omit `caption` to use the video's `brief.description`. Publishing needs a paid plan (`warning-plan-publish`) and a rendered video (`warning-publish-not-configured`). Platforms with no connected account are reported back as `missingPlatforms` rather than failing the whole call, unless none of the requested platforms resolves, which is `warning-publish-no-accounts`. An account whose authorization expired is `warning-publish-auth`, and reconnecting it in Settings clears that. Send an `Idempotency-Key`: a timed-out retry would otherwise post the same video twice.