qcQueue

Mock

Mock. This operation is part of the approved contract but its module is not built yet. Run Core with N1_API_MODE=mock N1_DEV_AUTH=stub to get deterministic demo-shop data from it. The real server answers NOT_IMPLEMENTED until it ships; the schema and examples here will not change when it does.

Job operations waiting for a quality check, oldest first

Try this operation →Use Postman ↗

Job operations waiting for a check, oldest first. Owner, admin, supervisor and QC.

POST/graphqlapp audience

Who can call this. Owner, admin, supervisor, QC.

Headers

Required Optional

AuthorizationstringRequired
Bearer <token>, issued for this endpoint's audience. The token decides the shop and roles; nothing in the request body can change them.
Example: Bearer eyJhbGciOiJFZERTQSJ9…
Content-TypestringRequired
Always application/json. Only POST is accepted.
Example: application/json
X-Request-IdstringOptional
Your id for this request (8–128 characters of A–Z a–z 0–9 . _ : -). Echoed back in the response header and in every error, so you can quote it when reporting a problem. Core makes one if you send none.
Example: app-7f3c2a9e-checkout

Arguments

Required Optional

afterStringOptional
endCursor of the previous page.
beforeStringOptional
startCursor of the next page, when paging backwards.
filterQcQueueFilterOptional
Narrow by stage.
Show children
- stageQcStageOptional
  Only checks due at this stage.
firstIntOptional
Page size, 1–100 (default 20).
Example: 3
lastIntOptional
Page size when paging backwards, 1–100.

Returns

Required Optional

qcQueueQcQueueItemConnection!Required
Job operations waiting for a check, oldest first. Owner, admin, supervisor and QC.
Show children
- edges[QcQueueItemEdge!]!Required
  The rows on this page, in order.
  Example: [{"cursor":"WyIyMDI2LTEwLTA1VDIxOjMwOjAwLjAwMFoiLCIwMTkyZjBjMS0wMDAwLTcwMDAtODAwMC0wMDAwMDBkMzA1OGQiXQ","node":{"jobCardId":"0192f0c1-0000-7000-8000-000000d2008e","jobOperationId":"0192f0c1-0000-7000-8000-000000d3058d","qrValue":"JC-00028","operationName":"Drilling","part":"Shaft 40x200","quantity":40,"stage":"RAW_MATERIAL","waitingSince":"2026-10-05T21:30:00.000Z"}},{"cursor":"WyIyMDI2LTEwLTA2VDAwOjMwOjAwLjAwMFoiLCIwMTkyZjBjMS0wMDAwLTcwMDAtODAwMC0wMDAwMDBkMzA3NzgiXQ","node":{"jobCardId":"0192f0c1-0000-7000-8000-000000d200bf","jobOperationId":"0192f0c1-0000-7000-8000-000000d30778","qrValue":"JC-00037","operationName":"Milling","part":"Spindle Nut","quantity":40,"stage":"IN_PROCESS","waitingSince":"2026-10-06T00:30:00.000Z"}},{"cursor":"WyIyMDI2LTEwLTA2VDIxOjMwOjAwLjAwMFoiLCIwMTkyZjBjMS0wMDAwLTcwMDAtODAwMC0wMDAwMDBkMzA5MDciXQ","node":{"jobCardId":"0192f0c1-0000-7000-8000-000000d200e7","jobOperationId":"0192f0c1-0000-7000-8000-000000d30907","qrValue":"JC-00045","operationName":"Turning","part":"Shaft 40x200","quantity":120,"stage":"RAW_MATERIAL","waitingSince":"2026-10-06T21:30:00.000Z"}}]
  Show children
  - cursorString!Required
    Opaque position of this row in the list.
    Example: "WyIyMDI2LTEwLTA1VDIxOjMwOjAwLjAwMFoiLCIwMTkyZjBjMS0wMDAwLTcwMDAtODAwMC0wMDAwMDBkMzA1OGQiXQ"
  - nodeQcQueueItem!Required
    The QcQueueItem.
    Example: {"jobCardId":"0192f0c1-0000-7000-8000-000000d2008e","jobOperationId":"0192f0c1-0000-7000-8000-000000d3058d","qrValue":"JC-00028","operationName":"Drilling","part":"Shaft 40x200","quantity":40,"stage":"RAW_MATERIAL","waitingSince":"2026-10-05T21:30:00.000Z"}
    Show children
    jobCardIdID!Required
    The job card to check.
    Example: "0192f0c1-0000-7000-8000-000000d2008e"
    jobOperationIdID!Required
    The step to check; pass it to recordQc.
    Example: "0192f0c1-0000-7000-8000-000000d3058d"
    operationNameString!Required
    What the step does.
    Example: "Drilling"
    partString!Required
    Part name or number.
    Example: "Shaft 40x200"
    qrValueString!Required
    The job card’s QR text.
    Example: "JC-00028"
    quantityInt!Required
    Pieces on the job.
    Example: 40
    stageQcStage!Required
    Which check is due.
    Example: "RAW_MATERIAL"
    FINALOn the finished part.
    IN_PROCESSBetween operations.
    RAW_MATERIALOn the material before work starts.
    waitingSinceString!Required
    UTC time the check became due. The queue is oldest first.
    Example: "2026-10-05T21:30:00.000Z"
- pageInfoPageInfo!Required
  Whether more pages exist, and the cursors to reach them.
  Example: {"hasNextPage":true,"hasPreviousPage":false,"endCursor":"WyIyMDI2LTEwLTA2VDIxOjMwOjAwLjAwMFoiLCIwMTkyZjBjMS0wMDAwLTcwMDAtODAwMC0wMDAwMDBkMzA5MDciXQ"}
  Show children
  - endCursorStringOptional
    Cursor of the last row; pass it as after to get the next page. Null when the page is empty.
    Example: "WyIyMDI2LTEwLTA2VDIxOjMwOjAwLjAwMFoiLCIwMTkyZjBjMS0wMDAwLTcwMDAtODAwMC0wMDAwMDBkMzA5MDciXQ"
  - hasNextPageBoolean!Required
    Whether another page follows this one.
    Example: true
  - hasPreviousPageBoolean!Required
    Whether another page comes before this one.
    Example: false
  - startCursorStringOptional
    Cursor of the first row; pass it as before to page backwards. Null when the page is empty.
- totalCountInt!Required
  All rows matching the filter and search, not just this page.
  Example: 24

Errors

Code	HTTP	When
`VALIDATION_FAILED`	`400`	Input failed Zod or route schema validation. `details` lists each field path and problem.
`FORBIDDEN`	`403`	Signed in, but the role or tenant does not allow the action.

Every error has the same body. See Errors.

Rate limit tier

Tier: per user. Over the limit you get RATE_LIMITED (HTTP 429) with a Retry-After header. See Response handling.