DeepMark

Get Ingestion Job State

ingestion_get

Read-onlyIdempotent

Read the current state of an ingestion job (paper creation or document ingestion). Returns the status plus a derived awaiting gate ('triage' | 'confirmation' | null), whether it is terminal, and the next action to take. Poll this after starting a job: a paper-creation job parks at awaiting_confirmation (then call paper_confirm) — it does NOT run to complete on its own. Stop polling on a terminal status (complete | failed | cancelled) or when an action is required.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`job_id`	Yes	ID of the ingestion job to read the current state of.

Output Schema

TableJSON Schema

Name	Required	Description
`kind`	Yes	The ingestion job kind (paper_bundle, student_batch, source_document, …).
`error`	Yes	Failure detail, when status is failed.
`job_id`	Yes
`status`	Yes	Raw ingestion status.
`awaiting`	Yes	The gate the job is parked at, or null if none. `start` means it has not been handed to a queue at all and a person must act before it is — polling will never resolve it.
`terminal`	Yes	True once the job will not change on its own.
`created_at`	Yes	ISO-8601 creation timestamp.
`needs_action`	Yes	Human-readable next step for the caller.
`processed_at`	Yes	ISO-8601 completion timestamp, or null if not yet processed.
`attempt_count`	Yes	Processing attempts so far.
`exam_paper_id`	Yes	The minted paper's id, once one exists.
`triage_summary`	Yes	Triage explanation, only while parked at the triage gate.
`triage_issue_count`	Yes	How many triage issues, only while parked at the triage gate.

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedOct 8, 2026

changedOutput schema / properties / awaiting / anyOf

Previous value: -[
-  {
-    "enum": [
-      "triage",
-      "confirmation"
-    ],
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "enum": [
+      "start",
+      "triage",
+      "confirmation"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / awaiting / description

Previous value: -"The gate the job is parked at, or null if none."New value: +"The gate the job is parked at, or null if none. `start` means it has not been handed to a queue at all and a person must act before it is — polling will never resolve it."

First observedJul 22, 2026

TDQS

Score is being calculated.

All DeepMark tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?