Browse content-type starter templates

curl --request GET \
  --url https://api.lighton.ai/api/v3/content-types/templates \
  --header 'Authorization: Bearer <token>'

{
  "id": null,
  "code": 401,
  "error": "unauthorized",
  "detail": "Authentication credentials were not provided or are invalid.",
  "doc_url": "https://developers.lighton.ai/errors#unauthorized"
}

Facets

Browse content-type starter templates

Browse the platform’s starter-kit templates for content types. These are ready-made taxonomies (legal, finance, healthcare, tech, manufacturing) you can adopt to quickly organise your documents, no manual setup required.

Getting started:

Browse templates here to see what’s available
Adopt the ones you need: POST /api/v3/content-types {"action": "adopt", "paths": ["legal", "finance"]}
Once adopted, they become your company’s own content types, fully editable
Customize: rename nodes, add children, define new attributes, or delete what you don’t need
Create entirely new content types from scratch with define_content_type

All write operations happen on POST /api/v3/content-types. This endpoint is read-only: it shows the catalog of available templates.

After adoption, manage your company’s content types (adopted + custom) via GET /api/v3/content-types and POST /api/v3/content-types. Classify files with POST /api/v3/files/{id}/facets.

Query modes:

No params → full detail for all templates (children + attributes)
?path=legal → detail for one template
?path=legal,finance → detail for multiple (comma-separated)
?path=legal:contract:nda → detail for a nested node
?depth=0 → root info only (code, label, description, no children/attributes)
?depth=1 → roots + direct children only
?include_attributes=false: omit attribute definitions for a lighter response

Path separator: : (colon). Example: legal:contract:nda

Attribute inheritance: Attributes defined at a parent node are inherited by all its children. A document classified as legal:contract:nda gets attributes from legal, legal:contract, and legal:contract:nda.

GET

api

content-types

templates

Browse content-type starter templates

curl --request GET \
  --url https://api.lighton.ai/api/v3/content-types/templates \
  --header 'Authorization: Bearer <token>'

{
  "id": null,
  "code": 401,
  "error": "unauthorized",
  "detail": "Authentication credentials were not provided or are invalid.",
  "doc_url": "https://developers.lighton.ai/errors#unauthorized"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

depth

integer

Tree depth limit. Default (omitted) = full tree. 0 = root info only (no children, no attributes). 1 = roots + direct children. N = N levels of children.

include_attributes

boolean

Include attribute definitions per content type node. Default: true.

path

string

Content type path(s), colon-separated hierarchy. Comma-separated for multiple (e.g., ?path=legal,finance, ?path=patent,sic, or ?path=legal:contract:nda). Root codes: finance, healthcare, legal, manufacturing, patent, sic, tech

Response

Content types returned successfully

Manage content types and attributes Get a file's content types and attributes

⌘I