Skip to content
GigAI

Get how far the assess batch is

GET
/api/postings/assess/status
curl --request GET \
  --url http://127.0.0.1:8765/api/postings/assess/status

How far the running assess batch is, and how the last one ended. 0.1.11.5: what the Jobs page and a job page poll while an assess batch runs. batch is the live batch of this project, or null: total, assessed, failed, in_flight (model calls running now), profile_id (the profile of the call started last), estimate_seconds (what the question estimated for the batch), pending (the job identities with no result yet) and status running or cancelling. It is read from the batch’s own marker file, whichever process runs the batch (here: this server; false: a terminal’s gigai scout jobs assess --yes or gigai scout new --yes): no store, posting or journal read, so it costs the same on a small and on a very large home. last is how the last batch this server ran ended (status done, cancelled or failed; requested, assessed, failed, not_started, failed_codes), or null. Ids, codes and counts, and pending, which holds posting URLs: the answer is labelled public-untrusted for them.

Responses

Section titled “Responses”

200

Section titled “200”

Success.

Media typeapplication/json
object
schema_version
required
Allowed value: scout-assess-batch:1
key
additional properties
any
Example
{
  "batch": {
    "assessed": 12,
    "estimate_seconds": 1730,
    "failed": 1,
    "here": true,
    "id": "batch_5f0c2d9a41e84b6f9d3f2a7c1b0e6d58",
    "in_flight": 4,
    "pending": [
      "https://boards.greenhouse.io/acme/jobs/101"
    ],
    "profile_id": "prof_1",
    "started_at": "2026-10-06T09:30:00Z",
    "status": "running",
    "total": 50
  },
  "last": {
    "assessed": 14,
    "error_code": null,
    "failed": 0,
    "failed_codes": [],
    "finished_at": "2026-10-06T09:12:40Z",
    "id": "batch_0d1e7c55a3b94c1e8a6f4b2d9c7e3f10",
    "more_after": 55,
    "not_started": 36,
    "requested": 50,
    "status": "cancelled"
  },
  "running": true,
  "schema_version": "scout-assess-batch:1"
}

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”

Target_unavailable

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

422

Section titled “422”

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": "unknown_key",
    "message": "..."
  }
}