Skip to main content

Delete Schema

Permanently delete a saved extraction schema with DELETE /v1/schemas/:id. Extraction results are retained; only the schema definition itself is removed.

The DELETE /v1/schemas/:id endpoint permanently deletes a saved extraction schema from your organization. This operation is irreversible. Associated extractions are retained and remain accessible: only the schema definition itself is removed.

Deleting a schema does not delete its associated extractions. Extraction results remain available via the extractions API.
DELETE/v1/schemas/:id

Delete a schema

curl -X DELETE https://api.talonic.com/v1/schemas/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer $TALONIC_API_KEY"

Response

Response fields

deletedbooleanAlways true on success.
idstringID of the deleted schema.

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

Error responses

400validation_errorInvalid schema identifier format.
401unauthorizedMissing or invalid API key.
403insufficient_scopeAPI key lacks the write scope required for this action.
404schema_not_foundNo schema with this ID exists for your organization.
429rate_limitedToo many requests. Retry after the period indicated in the Retry-After header.

Frequently asked questions

What happens to extractions when I delete a schema?+
Extractions are retained and remain accessible. Only the schema definition is removed. You can still query extraction results via the extractions API.
Can I recover a deleted schema?+
No. Schema deletion is permanent. If you need the same structure again, create a new schema with the same definition.
How do I find the ID of the schema I want to delete?+
List your schemas with `GET /v1/schemas` and use the `search` query parameter to filter by name. Each result includes the schema `id` and `SCH-` short ID, either of which works as the `:id` path parameter.

Related

List Schemas
Get Schema
Create Schema