Add Title Card
add_text_overlayAdd an opening title card (hook) or generic text overlay to a project timeline. Defaults to classic white: black text on a white card.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"projectId": "<projectId>",
"text": "<text>",
"idempotencyKey": "<idempotencyKey>"
},
"name": "add_text_overlay"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | title_card is an opening hook. lower_third is a speaker label (name and role on separate lines). overlay is generic on-video text. | title_card |
| name | No | ||
| size | No | Title-card size. Ignored for overlay. | default |
| text | Yes | ||
| theme | No | Title-card look. classic_white is black text on a white card. Ignored for overlay. | classic_white |
| projectId | Yes | UUID string. | |
| layerIndex | No | ||
| startSeconds | No | ||
| idempotencyKey | Yes | Retry key. Reuse only with identical inputs. | |
| durationSeconds | No | ||
| expectedRevision | No | Expected sequence revision, or null. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| txid | Yes | ||
| result | Yes | ||
| replayed | Yes | ||
| revision | Yes | ||
| warnings | Yes | ||
| projectId | Yes | ||
| operationId | Yes | ||
| baseRevision | Yes | ||
| mutationReceipt | Yes | ||
| createdTimelineItemIds | Yes | ||
| deletedTimelineItemIds | Yes | ||
| affectedTimelineItemIds | Yes |