List tasks
Returns every active task in your account: its key, name, optional goal, and success condition on one line. Built for an agent discovering which task_key values it can open outcomes against.
GET /v1/tasks is scoped to your account and never returns deleted tasks.
Example
curl https://api.thewitn.com/v1/tasks \
-H "Authorization: Bearer $WITN_API_KEY"{
"tasks": [
{
"key": "resolve-ticket",
"name": "Resolve ticket",
"goal": "Resolve the customer's billing ticket",
"condition": "COUNT(agent_response)>=2 AND NOT escalated"
}
]
}Fields
| Field | Meaning |
|---|---|
key | The task identifier. Pass it as task_key when opening an outcome. |
name | Human-readable task name. |
goal | The task goal. Nullable. |
condition | The success condition on one line, without live state. |
Reading the condition
condition keeps the AND/OR/NOT structure and temporal operators (IDLE, G, F) of the task's success condition, with comparison operators written tight, for example COUNT(agent_response)>=2. It carries no state glyphs or bracketed values: a task is a template, so there is nothing to evaluate yet. The same condition on a live outcome is returned annotated by GET /v1/outcomes/{key}.
Errors
| Code | Status | When |
|---|---|---|
TOKEN_INVALID | 401 | The token is missing or not recognised. |