Add an answer or completed uploads

Files must be completed uploads owned by the member. For external screen recordings, transfer the complete original with upload_my_file and complete_my_file first, then set files[].recordingMode to screen here. recordingMode accepts screen or camera, defaulting to camera. Toma validates processed content independently of the declaration. The five-minute clip and 100 MiB file limits remain. Prepared explicit task recordings become public only after approval; original uploads and answers remain private. unavailable requires an explanation and reassessment rather than automatically waiving a consequential gap. New sessions begin assessment only after analyze. A fresh handoff is unnecessary when existing Context is sufficient.

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

Request

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

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.