Skip to content
GigAI

List the pipeline approvals

GET
/api/pipeline/approvals
curl --request GET \
  --url 'http://127.0.0.1:8765/api/pipeline/approvals?state=pending'

The approvals: jobs over the per-trigger cap that wait for a yes, with what running them would cost. System data only: ids, codes, counts, numbers and timestamps. A job is named by its job_identity (the posting’s public link). No posting, resume, answer or story text, no title, no company. One trigger (an answer, a story, a changed profile) queues at most pipeline.auto_jobs_per_trigger jobs (10); the rest wait in one approval and nothing of theirs runs until it is approved. jobs is how many it held when it was made, waiting_jobs and waiting the ones still waiting, est_calls the model calls they would make and est_tokens the tokens, from the recorded calls (null when the history cannot say). A pending approval whose jobs were all processed one by one or cancelled is not listed. Oldest first.

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
state
string
Allowed values: pending approved declined expired

Only approvals in this state.

Responses

Section titled “Responses”

200

Section titled “200”

Success.

Media typeapplication/json
object
schema_version
required
Allowed value: scout-pipeline-approvals:1
key
additional properties
any
Example
{
  "approvals": [
    {
      "created_at": "2026-10-03T09:30:00.000000Z",
      "decided_at": null,
      "decided_by": null,
      "est_calls": 4,
      "est_tokens": 78000,
      "id": "apv_0123456789abcdef0123456789abcdef",
      "jobs": 2,
      "profile_id": null,
      "state": "pending",
      "trigger": "answer_saved",
      "waiting": [
        {
          "job_identity": "https://boards.greenhouse.io/acme/jobs/111",
          "profile_id": "prof_1"
        },
        {
          "job_identity": "https://boards.greenhouse.io/acme/jobs/112",
          "profile_id": "prof_1"
        }
      ],
      "waiting_jobs": 2
    }
  ],
  "pending": 1,
  "schema_version": "scout-pipeline-approvals: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, bad_enum

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