Skip to main content

Get Class

Retrieve a schema graph class by ID with its current field definitions, version number, document count, and links to version history. Requires read scope.

GET/v1/schema-graph/classes/{id}

Response

Response fields

idstringSchema class UUID.
schema_classstringCanonical class name.
document_type_idstring | nullAssociated document type UUID.
descriptionstring | nullOptional description.
current_version_idstring | nullUUID of the current active version.
statusstringClass status.
created_atstringISO 8601 creation timestamp.
updated_atstringISO 8601 last update timestamp.
links.selfstringURL to this class.
links.versionsstringURL to this class's version history.

Response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "schema_class": "Invoice",
  "document_type_id": "doc-type-uuid",
  "description": "Standard invoice schema class",
  "current_version_id": "ver-uuid-3",
  "status": "active",
  "created_at": "2024-08-01T00:00:00.000Z",
  "updated_at": "2024-09-14T00:00:00.000Z",
  "links": {
    "self": "/v1/schema-graph/classes/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "versions": "/v1/schema-graph/classes/a1b2c3d4-e5f6-7890-abcd-ef1234567890/versions"
  }
}

Errors

Error responses

401unauthorizedMissing or invalid API key.
404not_foundNo schema class with this ID exists for your organization.
429rate_limitedToo many requests. Retry after the period indicated in the Retry-After header.

Related

List Classes
List Versions