Sign in
Schemas

putSchema

Create or update a schema with a new version.

put/v1/entity/schemas/{slug}

Path parameters

slugstring required

URL-friendly identifier for the entity schema

Example:contact

Entity Type

Query parameters

draftboolean

Request body

slugstring required

URL-friendly identifier for the entity schema

versioninteger
blueprintstring uuid

Reference to blueprint

feature_flagstring

This schema should only be active when the feature flag is enabled

enable_settingstring[]

This schema should only be active when one of the organization settings is enabled

namestring required

User-friendly identifier for the entity schema

pluralstring required
descriptionstring
docs_urlstring uri
categorystring
publishedboolean
draftboolean
iconstring
title_templatestring

Template for rendering the title field. Uses handlebars

dialog_configobject
attributesAttribute[] required— unresolved $ref

An ordered list of attributes the entity contains

_purposestring[]
_manifeststring[] nullable

Manifest ID used to create the schema

explicit_search_mappingsSearchMappings

Advanced: explicit Elasticsearch index mapping definitions for entity data

Response

Success

idstring uuid

Generated uuid for schema

created_atstring
updated_atstring
commentstring
frozenboolean

No longer returned: schema freezing is retired.

latestboolean

No longer returned: every read returns the latest version.

_summaryboolean

Indicates this is a truncated summary schema (attributes trimmed to summary_attributes only, no capabilities or group_settings)

slugstring required

URL-friendly identifier for the entity schema

versioninteger
blueprintstring uuid

Reference to blueprint

feature_flagstring

This schema should only be active when the feature flag is enabled

enable_settingstring[]

This schema should only be active when one of the organization settings is enabled

namestring required

User-friendly identifier for the entity schema

pluralstring required
descriptionstring
docs_urlstring uri
categorystring
publishedboolean
draftboolean
iconstring
title_templatestring

Template for rendering the title field. Uses handlebars

dialog_configobject
attributesAttribute[] required— unresolved $ref

An ordered list of attributes the entity contains

_purposestring[]
_manifeststring[] nullable

Manifest ID used to create the schema

explicit_search_mappingsSearchMappings

Advanced: explicit Elasticsearch index mapping definitions for entity data

Changes