List Classes

List schema graph classes: the versioned ontology of document types Talonic discovers across your workspace, each with its canonical fields and version links.

The schema graph is a versioned ontology of document classes that Talonic discovers automatically across your workspace. Each class represents one recurring document type (an Invoice, a Purchase Order, a Lease Agreement) and captures its canonical fields as a JSON Schema. This endpoint lists every schema graph class in your organization, newest first, so you can see which document types the platform has learned from your data.

The API around the schema graph exposes five surfaces: versioned classes (this endpoint and its detail view), version history per class, diffs between versions with a review workflow, inter-class edges that measure how document types relate, and a D3-compatible visualization payload. Use the class list as the entry point: each item links to its own detail and version history.

Classes are created automatically as the platform processes documents and detects recurring field patterns. You never create a class by hand. Each class carries a status, a current_version_id pointing at its latest published version, and an optional document_type_id that ties it to the document classification pipeline.

curl -s https://api.talonic.com/v1/schema-graph/classes \
  -H "Authorization: Bearer tlnc_your_api_key"

Response

{
  "data": [
    {
      "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