Skip to content
GigAI

Assess every posting of a run

POST
/api/runs/{run_id}/assess-all
curl --request POST \
  --url http://127.0.0.1:8765/api/runs/example/assess-all \
  --header 'Content-Type: application/json' \
  --data '{ "start": true }'

Assess every unassessed posting of a finished run (start / cancel / read). {} reads the plan and starts nothing. The queue is the run’s new postings not assessed yet, plus every posting of the run whose stored assessment for the selected profile was made with older settings (see basis_stale on GET /api/assessments): plan.count = plan.new_count + plan.stale_count. A current stored assessment is skipped. Only {"start": true} calls a model. 50 AT A TIME: one start assesses the NEWEST 50 of the queue and never more (by the day the posting went up); plan.count is then the 50, and plan.total / plan.more_after say how many there are in all and how many are left (neither key is there when the queue is 50 or fewer). The next start takes the next 50.

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
run_id
required
string

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

Request Body

Section titled “Request Body”
Media typeapplication/json
object
cancel

True stops.

boolean
start

True starts.

boolean
Example
{
  "start": true
}

Responses

Section titled “Responses”

200

Section titled “200”

Success.

Media typeapplication/json
object
key
additional properties
any
Example
{
  "counts": {},
  "state": "idle"
}

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

415

Section titled “415”

Unsupported_media_type: writes need Content-Type: application/json.

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

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