---
title: "List tasks, newest first"
url: https://hexelstudio.com/docs/api/harness/tasks/list
---

# List tasks, newest first

**GET** `/harness/tasks`

Your own tasks, or anyone's with `harness:task:admin`. Page on with `before=<next_before>`.

## Query parameters

- `state: optional string`

- `limit: optional integer`

  Default: `50`

- `created_by: optional string`

  With harness:task:admin, one person's tasks.

- `before: optional string`

  An RFC 3339 time (a previous page's next_before).

## Headers

- `Authorization: string`

  `Bearer <token>`. A Hexel Studio access token for your organization.

- `X-Workspace-Id: string`

  The workspace the request acts in (`ws_...`). It never grants access by itself.

- `X-Environment-Id: string`

  The environment the request acts in (`env_...`). It never grants access by itself.

## Returns

`200` A page of tasks. (`object`)

- `tasks: array of Task`

  - `agent: string`

  - `agent_id: string`

  - `budget: any`

    Any JSON value.

  - `bundle_digest: string`

  - `cost_usd: number`

  - `created_at: string`

  - `created_by: string`

  - `end_reason: optional string`

  - `environment_id: string`

  - `erased_at: optional string`

  - `goal: string`

  - `goal_digest: optional string`

  - `held_at: optional string`

  - `id: string`

  - `inputs: any`

    Any JSON value.

  - `inputs_digest: optional string`

  - `last_seq: integer`

  - `org_id: string`

  - `outputs: optional object`

    - `text: optional string`

      The agent's last message.

    - `result: optional any`

      The structured result, when the agent gave one.

  - `run_id: string`

  - `sandbox_template: optional string`

  - `state: string`

    One of: `"queued"`, `"running"`, `"waiting"`, `"paused"`, `"succeeded"`, `"failed"`, `"budget_exhausted"`, `"cancelled"`

  - `swarm_id: optional string`

  - `tokens_in: integer`

  - `tokens_out: integer`

  - `updated_at: string`

  - `version: integer`

  - `waiting_reason: optional string`

  - `workspace_id: string`

- `next_before: optional string`

  Present when the page is full.

## Errors

- `default` 

## Example

```bash
curl --request GET \
  --url 'https://api.hexelstudio.com/v1/harness/tasks' \
  --header "Authorization: Bearer $ACCESS_TOKEN" \
  --header 'X-Workspace-Id: X_WORKSPACE_ID' \
  --header 'X-Environment-Id: X_ENVIRONMENT_ID'
```

### Response (200)

```json
{
  "tasks": [
    {
      "agent": "string",
      "agent_id": "string",
      "budget": "string",
      "bundle_digest": "string",
      "cost_usd": 0,
      "created_at": "2026-01-01T00:00:00Z",
      "created_by": "string",
      "end_reason": "string",
      "environment_id": "string",
      "erased_at": "2026-01-01T00:00:00Z",
      "goal": "string",
      "goal_digest": "string",
      "held_at": "2026-01-01T00:00:00Z",
      "id": "string",
      "inputs": "string",
      "inputs_digest": "string",
      "last_seq": 0,
      "org_id": "string",
      "outputs": {
        "text": "string",
        "result": "string"
      },
      "run_id": "string",
      "sandbox_template": "string",
      "state": "queued",
      "swarm_id": "string",
      "tokens_in": 0,
      "tokens_out": 0,
      "updated_at": "2026-01-01T00:00:00Z",
      "version": 0,
      "waiting_reason": "string",
      "workspace_id": "string"
    }
  ],
  "next_before": "string"
}
```
