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 /v1/runs/get

cURL

recent

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

200

Example

{ "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

200

application/json

Success.

ok · boolean · required

data · object[] · required

Runs, newest first. Empty when there are none.

Show child attributes