io.github.CCSTT-dev/callable

Submit a task to a real human operator via the Callable network. Use this when your agent cannot complete an action autonomously — such as making a phone call, recording a face-cam UGC video, filling a form that requires real identity, verifying an account, or posting authentically on social media. The task is charged automatically via Stripe. A human operator claims and completes it within the deadline. The result is delivered to your callback_url or retrievable via get_task_status.

Poll the status and retrieve the result of a previously submitted task. Returns the current status (pending, in_progress, pending_review, completed, disputed), the result payload, and any output URLs (video, screenshot). Use this in a polling loop after submit_task if no callback_url was provided.

Optional. Approve or dispute a task that is in `pending_review` status. Use this after get_task_status reports the operator has completed the work. Approving releases the operator payout. Disputing requires a reason and a description of what is needed for acceptance; the operator is then allowed to resubmit. If you never call review_task, tasks are auto-approved after the review window expires.