Skip to content
GigAI

Get a run's live progress

GET
/api/runs/{run_id}/progress
curl --request GET \
  --url 'http://127.0.0.1:8765/api/runs/example/progress?summary=0'

A run’s live progress (postings, boards, assessments); ?summary=1 drops posting text.

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
run_id
required
string

A run id from GET /api/runs (run_…).

Query Parameters

Section titled “Query Parameters”
summary
string
Allowed values: 0 1

1 for the small form (no posting text).

Responses

Section titled “Responses”

200

Section titled “200”

Success.

Media typeapplication/json
object
key
additional properties
any
Example
{
  "boards": {},
  "postings": [],
  "run_id": "run_20260929T100000Z"
}

403

Section titled “403”

Forbidden / forbidden_origin: loopback peer and Host 127.0.0.1:<port> or localhost:<port> only (Origin too on writes).

Media typeapplication/json
object
error
required
object
allowed_keys
Array<string>
code
required
string
message
required
string
key
additional properties
any
Examplegenerated
{
  "error": {
    "allowed_keys": [
      "example"
    ],
    "code": "example",
    "message": "example"
  }
}

404

Section titled “404”

Not_found

Media typeapplication/json
object
error
required
object
allowed_keys
Array<string>
code
required
string
message
required
string
key
additional properties
any
Example
{
  "error": {
    "code": "not_found",
    "message": "..."
  }
}

422

Section titled “422”

Invalid_value, unknown_key

Media typeapplication/json
object
error
required
object
allowed_keys
Array<string>
code
required
string
message
required
string
key
additional properties
any
Example
{
  "error": {
    "code": "invalid_value",
    "message": "..."
  }
}