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.

metadata is the only part of this API that keeps each network's own field names (privacyLevel, categoryId, privacyStatus): they are forwarded to the network as-is, so renaming them here would only hide what actually goes out.

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 completed or failed. Failed items can be retried with POST /posts/{id}/items/{itemId}/retry.

Networks still rolling out reject the whole request with PLATFORM_UNAVAILABLE before anything is created.

post/posts

Request

  • Base URL: https://api.cut.pro/api/v1
  • URL: https://api.cut.pro/api/v1/posts
  • Auth: API key in header X-Api-Key

Request body

scheduled_atstring nullable

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

Response

Response for status 201

idstring required
item_countnumber required
scheduled_atstring nullable required
status'pending' | 'processing' required

Changes

No recorded changes to this operation across all 1 revision of this API.