Media · Video · Create a custom timestamp clip

Creates and renders a custom clip from an existing repurposing project whose transcription is ready. start_time and end_time are absolute source seconds. Returns a clip id immediately; poll getRepurposeClip until DONE or UPDATED for download_url.

Authentication

AuthorizationApi-Key

Header authentication of the form Api-Key <token>

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

project_idstringRequiredformat: "uuid"

Request

This endpoint expects an object.

titlestringRequired1-255 characters

start_timeintegerRequired0-86399

Absolute whole seconds from the start of the source media.

end_timeintegerRequired0-86399

Absolute whole seconds; must be later than start_time and within the source media duration.

descriptionstringOptionalDefaults to

Response

Resource or asynchronous submission result.

idstringOptionalformat: "uuid"

project_idstringOptionalformat: "uuid"

job_statusstringOptional

sourceenumOptional

Allowed values:

payloadmap from strings to anyOptional

story_idstring or nullOptionalformat: "uuid"

download_urlstring or nullOptional

Rendered clip URL. Read it after job_status is DONE or UPDATED.