latestOpenAPI 3.0.22026-08-1588147259.4 KB

3020984570dc

Schemas

freezeSchema

Freeze a schema at its current version, or at a specific version. When frozen, getSchema returns the frozen version by default. New edits via putSchema update the latest version without affecting the frozen version.

post/v1/entity/schemas/{slug}/freeze

Path parameters

slugstring required

URL-friendly identifier for the entity schema

Example:contact

Entity Type

Request body

version_idstring uuid

Generated uuid for schema

Response

Schema frozen successfully

idstring uuid

Generated uuid for schema

created_atstring

updated_atstring

commentstring

frozenboolean

Indicates this schema is currently frozen. Present when the returned version is the frozen version.

latestboolean

Indicates this is the latest version of the schema. Both frozen and latest can be true if no changes were made since freezing.

_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