TOtoma

Start or retry a contributed recording

For a new task, first add a contribution and use its returned session.id as id. Starting a take directly on the parent creation is refused. The contribution's capture link authorizes only that recording. Retakes remain within the contribution; existing version-1 recording sessions are also supported.

post/api/task-creations/{id}/takes

Request

  • Base URL
    https://www.toma.com
  • URL
    https://www.toma.com/api/task-creations/{id}/takes
  • 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

device'desktop' | 'mobile' required
mode'screen' | 'camera' | 'audio'

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.