Tasks

Run a task now

Start a real run of an existing task right away, outside its schedule. It does everything a scheduled run does: writes go through, deliveries are sent, and it appears in the run history. Use it for "run my weekly report now" instead of creating a copy of the task.

Pass instructions to add something for this run only ("this time also break out refunds"). The run reads them as extra instructions on top of the task's prompt; the saved task, its prompt and its schedule do not change, and later runs do not see them.

An inactive task can be run this way; the run does not switch it on. Called from an agent chat, the chat is signalled when the run ends, so it need not poll. 400 if instructions is not a string of at most 4000 characters; 422 if the task has expired or already has a run in flight, the account is already running its maximum number of task runs, or it is out of AI credits.

post/tasks/{id}/run

Request

  • Base URL: https://api.crevio.co/v1
  • URL: https://api.crevio.co/v1/tasks/{id}/run
  • Auth: API key in header Authorization

Path parameters

idstring required

Task id (task_...)

Headers

Idempotency-Keystring

Makes this write safe to retry: a repeat with the same key replays the first response instead of creating a second resource. Scoped to the account, remembered for 24 hours; reusing a key with a different payload is an error.

Request body

instructionsstring

Extra instructions for this run only, e.g. "This time also break out refunds by product." Not saved on the task.

Response

Accepted — the run executes in the background; poll GET /task_runs/{id}.

idstring required
objectstring required
task_idstring required
task_namestring required
chat_idstring nullable required

The run's own conversation (aichat_...): what it read, called and said. Read it with search_chats.

status'pending' | 'running' | 'completed' | 'failed' | 'needs_input' | 'timed_out' | 'unknown' | 'skipped' required
summarystring nullable required
error_messagestring nullable required
test_runboolean required
input_tokensinteger required
output_tokensinteger required
credits_consumedinteger required
tool_calls_countinteger required
duration_msinteger nullable required
started_atstring date-time nullable required
completed_atstring date-time nullable required
created_atstring date-time required
updated_atstring date-time required
skip_reason'condition' | 'no_paid_plan_or_credits' | 'no_recent_activity' | 'no_task_activity' | 'no_personal_sources' | 'wake_gate' | 'wake_limit' | 'rate_limited' | 'misfire' | 'task_busy' | 'account_at_capacity' | 'null' nullable required
skip_countinteger required
delivery_status'delivered' | 'not_delivered' | 'not_requested' | 'unknown' required
completion'verified' | 'recorded' | 'recovered' | 'null' nullable required

How the agent closed a completed run: verified (it re-checked the result), recorded (it reported without re-checking), or recovered (it never reported; summary is its last message). Null unless an agent turn completed the run.

trigger_source'scheduled' | 'event' | 'manual' required
trigger_eventobject nullable required

The event that started this run, {type, data}, exactly as the run received it; data matches the event's webhook payload. Null for a run no event started. POST /task_runs/{id}/replay runs the task again on it.

replay_ofstring nullable required

The run (trun_...) whose event this run replays. Null unless started by POST /task_runs/{id}/replay.

Changes

No recorded changes to this operation across all 2 revisions of this API.