Tasks

Create

Each create tool takes a brief plus the fields for that job. Pass quote_only true to price it. Omit it to create the task after the user agrees.

• finishthis_humanize — draft and brief. Optional voice_target.
• finishthis_feedback — draft, feedback_type (line-level, big-picture, or both), and brief. Optional questions.
• finishthis_edit — draft, edit_scope (light or heavy), and brief. Optional preserve.
• finishthis_write — prompt and brief. Optional source_material. Write is off until the account turns it on.

confirm is required when the high end is above the auto-approve amount. max_price is an integer in cents. The task is refused when the high end is above it. quality is standard or top. deadline sooner than 1 day is refused. idempotency_key repeats the same create.

Creating a task does not charge the card. The charge happens after the work is done and an exact amount is logged.

Read and reply

finishthis_get_tasks takes an optional task_id, mode (concise or detailed), cursor, and limit from 1 to 100. The default is concise and 10. Concise mode leaves out the deliverable. Filter with status or kind.

finishthis_reply takes task_id and action: accept, revision, or answer. A revision and an answer need a note. Accept marks the task completed. One revision is included.

finishthis_update_task and finishthis_cancel_task work while the status is backlog or todo. After a writer starts, use finishthis_reply. Cancelling a task that is already cancelled changes nothing.