Poll ingest job
Return the current state of an ingest job.
Terminal states (succeeded / failed) remain queryable
after the job completes. result.memories_created and
result.memories_updated carry thin references
({id, type, text}); fetch GET /v1/memories/{id} for the
full row. Returns 404 job_not_found for unknown ids or ids
belonging to a different org.
Documentation Index
Fetch the complete documentation index at: https://docs.mem.xtrace.ai/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
Long-lived org API key. Alternative: Authorization: Bearer <key>.
Required alongside the API key (no key→org reverse index).
Headers
Path Parameters
Response
Successful Response
Returned by POST /v1/memories (with status 202 by default,
200 when ?wait=true succeeds inline) and by
GET /v1/memories/jobs/{job_id}. Same wire shape across
every read of a job's lifecycle.
Opaque job id of the form job_<32-hex-chars>.
"job_a1b2c3d4e5f6071829304a5b6c7d8e9f"
Lifecycle state. pending → enqueued. running → extraction in progress. succeeded → result is set. failed → error is set. Terminal jobs (succeeded / failed) are retained for 24h before TTL sweep returns 404 job_not_found.
pending, running, succeeded, failed ISO-8601 timestamp the job was created.
Constant discriminator for the resource type.
"ingest_job"ISO-8601 timestamp of the most recent state transition.
Populated when status = succeeded; null otherwise.
Populated when status = failed; null otherwise.