Create a post

curl --request POST \
  --url https://api.cut.pro/api/v1/posts \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "videos": [
    {
      "editId": "<string>",
      "targets": [
        {
          "connectionId": "<string>",
          "metadata": {}
        }
      ]
    }
  ],
  "scheduled_at": "<string>"
}
'

{
  "post_id": "<string>",
  "item_count": 123,
  "scheduled_at": "<string>"
}

Posts

Create a post

Creates a multi-platform post for one or more edited clips. Each entry under videos references an edit_id (the rendered or apply_template’d clip) plus a list of target connections with platform-specific metadata.

Pass scheduled_at (ISO 8601, must be in the future) to schedule the post; omit it to publish immediately.

Immediate posts kick off rendering + publishing in the background — poll GET /posts/{id} until every item is published or failed. Failed items can be retried with POST /posts/{id}/items/{itemId}/retry.

POST

posts

Create a post

curl --request POST \
  --url https://api.cut.pro/api/v1/posts \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "videos": [
    {
      "editId": "<string>",
      "targets": [
        {
          "connectionId": "<string>",
          "metadata": {}
        }
      ]
    }
  ],
  "scheduled_at": "<string>"
}
'

{
  "post_id": "<string>",
  "item_count": 123,
  "scheduled_at": "<string>"
}

Authorizations

X-Api-Key

string

header

required

Body

videos

object[]

required

List of clips to publish. Each item has an editId plus per-target metadata.

Minimum array length: 1

Show child attributes

scheduled_at

string | null

ISO 8601 future timestamp to schedule the post. Omit for immediate publish.

Response

Response for status 201

post_id

string

required

item_count

number

required

scheduled_at

string | null

required

status

enum<string>

required

Available options:

pending,

processing

Last modified on May 27, 2026

List posts

Get a post

Documentation Index

Authorizations

Body

Response