TOtoma

Supply missing agent context and reassess the evidence

Only the owner may submit Context at the current revision. Files must be completed owned uploads. The handoff is retained and reassessed after analysis begins. Generation proceeds when consequential gaps are resolved; omitted deadlines are questions only when timing matters. This never approves public sharing or publishes. Existing sessions retain their previous lifecycle. MCP uses handoff because context is reserved for analytics.

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

Request

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

Path parameters

idstring required

Request body

revisioninteger required
contextstring 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.