Apply Reusable Character
characters_applyCreate or update a reference-based character for repeatable faceless story generation.
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": {
"name": "<name>",
"idempotencyKey": "<idempotencyKey>"
},
"name": "characters_apply"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| type | No | human | |
| species | No | ||
| storyFacts | No | ||
| characterId | No | ||
| workspaceId | No | Optional workspace UUID. Defaults to the user's default workspace. UUID string. | |
| defaultVoiceId | No | ||
| idempotencyKey | Yes | ||
| defaultVoiceStyle | No | ||
| referenceAssetIds | No | ||
| canonicalDescription | No | ||
| confirmLikenessConsent | No | For a human character, set true only after the user confirms consent to use the depicted person's likeness. | |
| primaryReferenceAssetId | No | ||
| confirmRightsToReferences | No | Set true only after the user confirms they own the reference media or have permission to use it. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| character | Yes | ||
| mutationReceipt | Yes |