Skip to content
Kindgi

The project's judging queue

GET
/v1/projects/{projectId}/judging-queue
curl --request GET \
  --url 'https://example.com/v1/projects/example/judging-queue?state=open&limit=25' \
  --header 'Authorization: Bearer <token>'

Queued runs, oldest first: never a run’s content, only what it was, which rules queued it, whose judgment they want and the judgments so far, and what the caller may do with it (can). An item closes as judged once every rule that queued it has the judgment it wants. forMe=true: the items any judgment closes, or that want a class the caller may assert. limit=0 answers only the total. Needs read on the project.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
projectId
required
string

ProjectId — opaque branded string.

Query Parameters

Section titled “Query Parameters”
state

Where a queued run stands. judged: every rule that queued it has the judgment it wants. erased: the run’s content is gone (erased, or the run purged); the item shows nothing of it.

string
Allowed values: open judged dismissed erased

Open, judged, dismissed or erased.

agentId
string

Only this agent.

ruleId
string

Only items this rule queued.

judgeClassId
string

Only items that want this class.

forMe
boolean

true: what the caller is asked to judge.

addedAfter
string format: date-time

Queued from this time on.

closedAfter
string format: date-time

Closed from this time on.

limit
integer
default: 25 >= 1 <= 100

Page size; 0 for the total alone.

cursor
string

Where the previous page ended: its nextCursor, as it came. A runtime that seals cursors takes one only for the same list, filters and caller, within a day; otherwise 400 bad-input, and the list starts again without it. Absent → first page.

Responses

Section titled “Responses”

200

Section titled “200”

A page of queued runs.

Media typeapplication/json
object
data
required
Array<object>

A queued run: never its content, only what it was and where it stands.

object
runId
required
string
projectId
required
string
agentId
string
agentVersion
string
flowId
required
string
runStatus
required

How a run ended.

string
Allowed values: completed failed cancelled
completedAt
required
string format: date-time
rules
required

The rules that queued it, each at the version that did.

Array<object>
object
ruleId
required
string
version
required
integer
>= 1
wantedClassIds
required

The judge classes its rules want.

Array<string>
anyJudgment
required

One of its rules wants any judgment.

boolean
progress
required

The live judgments on the run so far, by class.

object
total
required
integer
byClass
required
Array<object>
object
judgeClassId
required

null: unclassified.

string | null
count
required
integer
addedAt
required
string format: date-time
state
required

Where a queued run stands. judged: every rule that queued it has the judgment it wants. erased: the run’s content is gone (erased, or the run purged); the item shows nothing of it.

string
Allowed values: open judged dismissed erased
closedAt
string format: date-time
closedBy

Who dismissed or reopened it last.

string
reason

Why it was dismissed, when they said.

string
can
required

What the caller may do with the item, by the check the routes make (write on the project, as judging the run needs).

object
dismiss
required
boolean
reopen
required
boolean
hasMore
required
boolean
nextCursor
string
total
required

Every item the filters match, across pages.

integer
Example
{
  "data": [
    {
      "runStatus": "completed",
      "state": "open"
    }
  ]
}

400

Section titled “400”

A malformed filter (bad-input).

Media typeapplication/json
object
error
required
object
code
required

Stable machine-readable discriminant. Values match domain error codes (see docs/API-ROUTE-CONVENTIONS.md §4.3).

string
message
required
string
details

Optional, kind-specific.

object
key
additional properties
any
requestId
required

Server-assigned request id; also echoed via X-Request-Id header.

string
Examplegenerated
{
  "error": {
    "code": "example",
    "message": "example",
    "details": {},
    "requestId": "example"
  }
}

401

Section titled “401”

Missing / malformed / expired / revoked bearer token.

Media typeapplication/json
object
error
required
object
code
required

Stable machine-readable discriminant. Values match domain error codes (see docs/API-ROUTE-CONVENTIONS.md §4.3).

string
message
required
string
details

Optional, kind-specific.

object
key
additional properties
any
requestId
required

Server-assigned request id; also echoed via X-Request-Id header.

string
Examplegenerated
{
  "error": {
    "code": "example",
    "message": "example",
    "details": {},
    "requestId": "example"
  }
}

404

Section titled “404”

No project with that id (project-not-found).

Media typeapplication/json
object
error
required
object
code
required

Stable machine-readable discriminant. Values match domain error codes (see docs/API-ROUTE-CONVENTIONS.md §4.3).

string
message
required
string
details

Optional, kind-specific.

object
key
additional properties
any
requestId
required

Server-assigned request id; also echoed via X-Request-Id header.

string
Examplegenerated
{
  "error": {
    "code": "example",
    "message": "example",
    "details": {},
    "requestId": "example"
  }
}