Case Documents

Pin a document to a case so it survives rebuilds, or remove a wrongly linked document. Both curator decisions persist across case recomputes.

Manage document membership within a case. Pin a document to lock it into the case: pinned documents survive rebuilds even when the rebuild would otherwise drop them. Remove a document to detach it from the case when it was linked incorrectly.

Both operations are curator overrides, and both persist. A removed document is tombstoned on the case, so the next rebuild does not re-add it even if linking edges still connect it. Pinning a document that is not currently a member adds it to the case, provided the document belongs to your workspace.

Each endpoint returns the updated membership record for the document. The pin state is also visible as the pinned flag on each entry of the documents array in GET /v1/cases/:key.

Response

{
  "document_id": "doc_uuid_1",
  "pinned": true,
  "removed": false
}

Response

{
  "document_id": "doc_uuid_1",
  "pinned": false,
  "removed": true
}

Errors