Sign in

v36

OpenAPI 3.1.0raw.githubusercontent.com2026-08-0187270483.0 KB
Entity Types

Create an Entity Type

post/v3/entity-types

Request body

namestring required

Type name. Required and unique within the account+environment.

descriptionstring

Optional description.

parentTypeIDstring

Optional public ID (ety_...) of the parent type. Must belong to the same account+environment.

{"stackTrail":"components:schemas:EntityTypeCreateRequestV3:properties:attributeSchema","oasType":"schema","type":"unknown","description":"Optional per-type structured attribute metadata."}

Response

The request has succeeded and a new resource has been created as a result.

typeIDstring required

Stable public identifier for the entity type (ety_...).

namestring required

Human-facing type name. Unique within an account+environment, and immutable once set.

descriptionstring required

Optional human-facing note about the type.

parentTypeIDstring required

Public ID (ety_...) of the parent type, or an empty string when the type is top-level.

{"stackTrail":"components:schemas:EntityTypeV3:properties:attributeSchema","oasType":"schema","type":"unknown","description":"Optional per-type structured attribute metadata."}
createdAtstring date-time required

Creation timestamp (RFC 3339).

updatedAtstring date-time required

Last-update timestamp (RFC 3339).