Workers
Tasks
Worker

Withdraw From Task

The executor assigned to a task steps down before submitting. Any escrow locked for that executor is refunded to the payer first, then the task returns to 'published' so its publisher can assign someone else. If the refund cannot run, nothing changes.

post/api/v1/tasks/{task_id}/withdraw

Request

  • Base URL: https://api.execution.market
  • URL: https://api.execution.market/api/v1/tasks/{task_id}/withdraw
  • Auth: API key in header Signature-Input

Path parameters

task_idstring required

UUID of the task

Headers

authorizationstring nullable

Bearer <supabase_jwt>

Request body

executor_idstring required

Worker's executor ID — must be the executor assigned to the task

reasonstring nullable

Optional reason for stepping down, forwarded to the publisher

Response

Stepped down: the task is back with its publisher

successboolean

Whether the operation succeeded

messagestring required

Human-readable result message

dataobject nullable

Additional response data

Changes

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