Update Schema

Replace a schema definition, creating a new version internally. Existing extractions retain their original schema version.

PUT/v1/schemas/:id

Response

Response fields

idstringSchema UUID.

short_idstringHuman-readable short ID.

namestringUpdated schema name.

descriptionstring | nullUpdated description.

definitionobjectUpdated JSON Schema definition.

field_countintegerUpdated field count.

versionintegerSchema version number.

created_atstringISO 8601 creation timestamp.

updated_atstringISO 8601 last update timestamp.

linksobjectRelated resource URLs.

Response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "short_id": "SCH-A1B2C3D4",
  "name": "Invoice v2",
  "description": "Updated invoice schema with line items",
  "definition": {
    "type": "object",
    "properties": {
      "invoice_number": { "type": "string", "title": "invoice_number" },
      "vendor": { "type": "string", "title": "vendor" },
      "total": { "type": "number", "title": "total" },
      "date": { "type": "date", "title": "date" },
      "line_items": { "type": "array", "title": "line_items" }
    },
    "required": ["invoice_number"]
  },
  "field_count": 5,
  "version": 1,
  "created_at": "2024-08-20T14:00:00.000Z",
  "updated_at": "2024-09-15T10:30:00.000Z",
  "links": {
    "self": "/v1/schemas/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "extractions": "/v1/extractions?schema_id=a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "dashboard": "https://app.talonic.com/schemas/user/a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

Errors

Error responses

400validation_errorInvalid schema identifier format.

401unauthorizedMissing or invalid API key.

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.

Get Schema