# The project's judging queue GET /v1/projects/{projectId}/judging-queue ```sh curl --request GET \ --url 'https://example.com/v1/projects/example/judging-queue?state=open&limit=25' \ --header 'Authorization: Bearer ' ``` 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 - **[bearerAuth](https://docs.kindgi.com/v0.1.9/reference/api.md#bearerauth)** ## Parameters ### Path Parameters **projectId** required string ProjectId — opaque branded string. ### 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 ### 200 A page of queued runs. application/json object **data** required Array\ 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 **ruleId** required string **version** required integer \>= 1 **wantedClassIds** required The judge classes its rules want. Array\ **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 **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 ```json { "data": [ { "runStatus": "completed", "state": "open" } ] } ``` ### 400 A malformed filter (`bad-input`). application/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 ```json { "error": { "code": "example", "message": "example", "details": {}, "requestId": "example" } } ``` ### 401 Missing / malformed / expired / revoked bearer token. application/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 ```json { "error": { "code": "example", "message": "example", "details": {}, "requestId": "example" } } ``` ### 404 No project with that id (`project-not-found`). application/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 ```json { "error": { "code": "example", "message": "example", "details": {}, "requestId": "example" } } ``` ## See also - [`GET /v1/projects/{projectId}`: Fetch a project by id](https://docs.kindgi.com/v0.1.9/reference/api/operations/projectsget.md) - [`PATCH /v1/projects/{projectId}`: Partially update a project](https://docs.kindgi.com/v0.1.9/reference/api/operations/projectsupdate.md) - [`DELETE /v1/projects/{projectId}`: Delete a project (idempotent)](https://docs.kindgi.com/v0.1.9/reference/api/operations/projectsdelete.md) - [`GET /v1/projects/{projectId}/judging-rules`: List a project's judging rules](https://docs.kindgi.com/v0.1.9/reference/api/operations/projectsjudgingruleslist.md) - [Error code `bad-input`](https://docs.kindgi.com/v0.1.9/reference/errors.md#bad-input) - [Error code `project-not-found`](https://docs.kindgi.com/v0.1.9/reference/errors.md#project-not-found) - [Every error code](https://docs.kindgi.com/v0.1.9/reference/errors.md)