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

FieldMeaning
keyThe task identifier. Pass it as task_key when opening an outcome.
nameHuman-readable task name.
goalThe task goal. Nullable.
conditionThe 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

CodeStatusWhen
TOKEN_INVALID401The token is missing or not recognised.

On this page