PerceptionDocs

Add a schema version

Saves the next version of one of the account's schemas. Free, and works at any balance.

POST
/v1/extraction-schemas/{id}/versions
  • Earlier versions stay as they were, so an extract that names schema_version keeps getting the same schema.
  • name and description, when left out, carry over from the previous version.

Other errors (413, 500, 502, 503) are on Errors.

Authorization

bearerAuth
AuthorizationBearer <token>

Your API key from the dashboard's API Keys page: nace_sk_ followed by 43 URL-safe characters (A-Z, a-z, 0-9, _ and -), shown once when you create it. Send it as Authorization: Bearer nace_sk_... Any other value returns 401 authentication_error. An account can hold at most 3 active keys.

In: header

Path Parameters

id*string

The schema's schema_id (sch_...).

Lengthlength <= 128

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/extraction-schemas/string/versions" \  -H "Content-Type: application/json" \  -d '{    "schema": {}  }'
{  "schema_id": "string",  "name": "string",  "description": "string",  "version": 1,  "owner": "account",  "created_at": "2019-08-24T14:15:22Z",  "updated_at": "2019-08-24T14:15:22Z",  "schema": {}}

List a schema's versions GET

Every version of one of the account's schemas.

Get a schema version GET

One version of one of the account's schemas.