Delete Schema

Delete a schema by ID. Associated extractions are retained and not deleted when the schema is removed.

Permanently delete a schema from your organization. This operation is irreversible. Associated extractions are retained and remain accessible — only the schema definition itself is removed.

Response

{
  "deleted": true,
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Most integrations call this endpoint during cleanup when a schema is no longer needed, or when consolidating duplicate schemas. A typical workflow is to list schemas with GET /v1/schemas, identify obsolete ones, then delete them individually by id.

The response confirms deletion with deleted: true and the id of the removed schema. All extraction results that used this schema remain intact and queryable via GET /v1/extractions — only the schema definition itself is removed from the system.

Pair this with GET /v1/schemas/:id beforehand to review the schema before removing it. Note that deletion is permanent with no undo — if you need the same structure later, you must recreate it with POST /v1/schemas.

Errors