TOtoma

Rename a task draft

Saves the chosen title for the current unpublished revision. Preserves recordings, files, and answers, refreshes instructions for unstarted recordings, and reassesses existing context. Changing the title invalidates prior approval and the generated preview. Individual recordings and published creations cannot be renamed here.

patch/api/task-creations/{id}/title

Request

  • Base URL
    https://www.toma.com
  • URL
    https://www.toma.com/api/task-creations/{id}/title
  • Auth
    • HTTP bearer
    • or API key in cookie better-auth.session_token
    • or API key in header x-task-creation-token

Path parameters

idstring required

Request body

revisioninteger required
titlestring required

Response

The private task, including revision, source tracks, processing state, and preview. Owner reads also include structured analysis, stable draftId, commentsVersion, and pending draftComments. Capture capabilities do not grant these owner-only details. Answer evidence retains requestId and question wording after reassessment.

workflowVersioninteger
companionboolean
mode'screen' | 'camera' | 'audio'
idstring required
titlestring required
instructionstring nullable required
titleSuggestionsstring[] required
status'preparing' | 'recording' | 'processing' | 'review' | 'rendering' | 'context_preparing' | 'context' | 'generating' | 'ready' | 'publishing' | 'published' | 'discarded' | 'failed' required
revisioninteger required
approvedRevisioninteger nullable required
analysisRequestedboolean
draftIdstring nullable
commentsVersioninteger
quality'positive' | 'negative' nullable
taskIdstring nullable required
errorstring nullable required
createdAtstring required
updatedAtstring required

Changes

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