ClarifyAPI
Schemas

List object schemas

Returns every object schema in the workspace as a cursor-paginated list of JSON:API resources. Each resource holds the full JSON Schema for one object type, including its fields, relationships, and presentation metadata.

GET
/workspaces/{workspace}/schemas
Authorization<token>

API key authentication. Send your key in the Authorization header as: api-key <your-api-key>.

In: header

Path Parameters

workspace*string

The workspace slug — the {slug} segment of your Clarify workspace URL.

Response Body

application/json

curl -X GET "https://example.com/workspaces/string/schemas"
{  "links": {    "next": null  },  "data": [    {      "id": "https://getclarify.ai/schemas/entities/c_project",      "type": "schema",      "attributes": {        "$schema": "https://json-schema.org/draft/2020-12/clarify",        "$id": "https://getclarify.ai/schemas/entities/c_project",        "title": "Project",        "type": "object",        "xClarifyNamespace": "objects",        "xClarifyLabel": {          "singular": "Project",          "plural": "Projects"        },        "xClarifyAIDescription": "A customer project tracked alongside deals and companies.",        "properties": {          "name": {            "type": "string",            "title": "Name",            "xClarifyPrimary": true          },          "status": {            "type": [              "string",              "null"            ],            "title": "Status",            "enum": [              "Planning",              "In progress",              "Complete"            ]          },          "company_id": {            "type": [              "string",              "null"            ],            "title": "Company",            "xClarifyRelationship": {              "kind": "many-to-one",              "entity": "company",              "field": "projects"            }          }        }      }    }  ]}