Start a task recording

Creates a version-3 task preparation ready for recording without a title, description, or initial model call. Optional supplied wording is retained. Each member can have one unfinished new-task draft. A second start returns 409 with its recovery link; list with state=draft to resume, or explicitly discard the draft before starting another. Drafts survive closing, navigation, and processing failures until published or cancelled. Published-task revisions remain independent. Use the private recording link by default, or add a completed external screen recording through evidence with recordingMode set to screen. Every unpublished task requires a screen walkthrough with meaningful narration; supplied text and Context supplement it. The owner can explicitly accept an inconclusive content check for its current fingerprint through accept-recording. Explicitly call analyze to validate the recording, freeze Context, and begin understanding. Final approval and publication are separate operations.

post/api/task-creations

Request

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

Request body

titlestring

Write every newly generated title as a short proposition requesting work: for example, "Help me build a personal website", "I need my research organized", or "Get my report export working". Use a concrete action and desired result, never just a deliverable label such as "Personal website". Use sentence case without a trailing period, preserving proper names and acronyms.

descriptionstring

Response

A private recording link with an expiring token in its fragment. Keep it private.

idstring required
recordingUrlstring required
expiresAtstring required
status'preparing' | 'recording' | 'processing' | 'review' | 'rendering' | 'context_preparing' | 'context' | 'generating' | 'ready' | 'publishing' | 'published' | 'discarded' | 'failed' required
revisioninteger

Changes

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