List runs

Returns this daemon’s most recent runs, newest first: 20 unless you send limit, optionally only those of one workspace. Sub-runs are included as separate runs; use Get a run tree to see how they nest.

From the CLI: cliq logs --last.

No credential is needed from this machine. From another host, send Authorization: Bearer with a dispatch token CliqHub signed for this daemon or a cliq_tok_… personal token of a user in the daemon’s realm; this only works once the daemon is connected to CliqHub. See Authentication.

POST

runs

get

curl --request POST \
  --url http://127.0.0.1:4900/v1/runs/get \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

{
  "ok": true,
  "data": [
    {
      "run_id": "0c8d7e6f-5a4b-4c3d-9e2f-1a0b9c8d7e6f",
      "run_name": "fix-login-timeout",
      "workspace_id": "9b2e6f10-4c3a-4e7d-8f21-6a5b4c3d2e1f",
      "team_id": "3f6c2a8e-6b1d-4c1e-9a57-0d2f4b8e91c4",
      "team_label": "@acme/code-review",
      "daemon_id": null,
      "realm_id": null,
      "state": "completed",
      "execution_type": "local",
      "current_phase": null,
      "current_pid": null,
      "parent_run_id": null,
      "parent_phase": null,
      "root_run_id": null,
      "call_path": [
        "code-review"
      ],
      "call_depth": 0,
      "iteration_key": null,
      "inputs": {
        "pr_url": "https://github.com/acme/api/pull/42"
      },
      "external_id": null,
      "context_labels": null,
      "started_at": 1759834200000,
      "completed_at": 1759834500000,
      "error": null
    }
  ]
}

Authorizations

Authorization

string

header

required

Not needed from the same machine. From another host: a dispatch JWT CliqHub signed for this daemon, or a cliq_tok_… personal token whose user is in the daemon's realm.

Body

application/json

limit

number

Max runs to return (default 20)

workspace_id

string

Only runs of this workspace

{key}

any

Response

Success.

boolean

required

data

object[]

required

Runs, newest first. Empty when there are none.

Show child attributes

curl --request POST \
  --url http://127.0.0.1:4900/v1/runs/get \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

{
  "ok": true,
  "data": [
    {
      "run_id": "0c8d7e6f-5a4b-4c3d-9e2f-1a0b9c8d7e6f",
      "run_name": "fix-login-timeout",
      "workspace_id": "9b2e6f10-4c3a-4e7d-8f21-6a5b4c3d2e1f",
      "team_id": "3f6c2a8e-6b1d-4c1e-9a57-0d2f4b8e91c4",
      "team_label": "@acme/code-review",
      "daemon_id": null,
      "realm_id": null,
      "state": "completed",
      "execution_type": "local",
      "current_phase": null,
      "current_pid": null,
      "parent_run_id": null,
      "parent_phase": null,
      "root_run_id": null,
      "call_path": [
        "code-review"
      ],
      "call_depth": 0,
      "iteration_key": null,
      "inputs": {
        "pr_url": "https://github.com/acme/api/pull/42"
      },
      "external_id": null,
      "context_labels": null,
      "started_at": 1759834200000,
      "completed_at": 1759834500000,
      "error": null
    }
  ]
}

Introduction

System

Teams

Workspaces

Runs

Artifacts

Agents

Settings

Instances

Daemon

Sign-in

Local tokens

HUG

Hub commands

List runs

Authorizations

Body

Response