components

Move retired component clips to their native successors

Move clips stored in a retired form to their native (version 4) successors: a clip pinning a retired curated TSX (version 3) component, or one stored before execution pins (needsUpgrade kind unpinned-component), moves to the successorSourceVersionId the read or a refusal of such a clip names. Name clip_ids, or omit them to move every clip that has a successor. Every saved input is kept. Clips with no successor are listed in withoutSuccessor, and clips whose stored inputs the successor refuses in inputsRefused; a write never leaves a retired clip in place, so rebuild or remove those in the same edit that upgrades the others.

post/v1/projects/{id}/components/native-upgrade

Request

  • Base URL: https://api.cueframe.ai
  • URL: https://api.cueframe.ai/v1/projects/{id}/components/native-upgrade
  • 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

clip_idsstring[]

The clips (component placements) to move. Omit to move every clip that has a native successor.

composition_idstring

The composition to update; the project's active one when omitted.

Example request

{}

Response

The clips moved.

withoutSuccessorstring[] required

Clips in a retired form no curated release recorded: rebuild them as native components, or remove them, in the same edit that upgrades the others.

etagstring nullable required

Changes

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