clips

Build and persist a composition from a clip suggestion

Required permission: projects:write

post/v1/projects/{id}/composition/from-suggestion

Request

  • Base URL: https://api.cueframe.ai
  • URL: https://api.cueframe.ai/v1/projects/{id}/composition/from-suggestion
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.cueframe.ai/api/auth/mcp/authorize, token URL https://api.cueframe.ai/api/auth/mcp/token, scopes: projects:write)
    • API key in header PAYMENT-SIGNATURE

Path parameters

idstring required

Request body

suggestionIdstring required

Example request

{
  "suggestionId": "sug_01J8Z3K9Q2X4Y5W6V7T8R9S0P1"
}

Response

Composition saved; new ETag in header. notes names what the brief asked for that the composition does not carry.

compositionIdstring required
versionIdstring required
etagstring required

Changes

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