This page documents the canonical HTTP contract for this endpoint.
Use a signed-in user session. Developer API keys are blocked for this route. Records are scoped to the current organization.
Case-study reads project terminal ingestion status from the canonical operation receipt, so processing_status can show completed, failed, or cancelled even if a worker stopped before updating the asset record. Pending assets can show queued or processing; failures can include processing_error. The internal ingestion checkpoint is omitted. Read operation-run progress with operation_run_id; job_id is a separate native identity. Examples are abridged.
Errors
| Status | Meaning |
|---|---|
| 401 | A signed-in user session and organization context are required. |
| 403 | Developer API keys are blocked, or the caller lacks administrator permission for a write. |
| 404 | User or organization not found. |
| 422 | Invalid request fields. |
| 500 | Context read, save, or case-study admission failed. |
