--- title: "POST /entity-types/load" method: POST path: "/entity-types/load" tags: ["Graph", "EntityType"] --- # POST /entity-types/load `POST /entity-types/load` ## Headers - `X-Authenticated-User-Actor-Id` string, uuid, required ## Request body - union - object - `entityTypeId` string, uri, required — The versioned URL of a Block Protocol ontology type (the $id of the schema). It should be of the form `${baseUrl}v/${versionNumber}` - object - `provenance` ProvidedOntologyEditionProvenance, required — User-provided provenance information for an ontology type edition. Contains information provided by the client about the creation context, including the acting entity's type and the origin of the creation action. - `actorType` 'user' | 'machine' | 'ai', required — Types of individual actors in the system. Represents the different categories of entities that can perform actions. - `origin` union, required - object - `apiKeyPublicId` string - `deviceId` string - `environment` string - `id` string - `semanticVersion` string - `sessionId` string - `type` 'web-app', required - `userAgent` string - `version` string — The origin version, in whatever format the origin natively provides. - object - `apiKeyPublicId` string - `deviceId` string - `environment` string - `id` string - `semanticVersion` string - `sessionId` string - `type` 'mobile-app', required - `userAgent` string - `version` string — The origin version, in whatever format the origin natively provides. - object - `apiKeyPublicId` string - `deviceId` string - `environment` string - `id` string - `semanticVersion` string - `sessionId` string - `type` 'browser-extension', required - `userAgent` string - `version` string — The origin version, in whatever format the origin natively provides. - object - `apiKeyPublicId` string - `deviceId` string - `environment` string - `id` string - `semanticVersion` string - `sessionId` string - `type` 'api', required - `userAgent` string - `version` string — The origin version, in whatever format the origin natively provides. - object - `apiKeyPublicId` string - `deviceId` string - `environment` string - `id` string - `semanticVersion` string - `sessionId` string - `stepIds` string[] - `type` 'flow', required - `userAgent` string - `version` string — The origin version, in whatever format the origin natively provides. - object - `apiKeyPublicId` string - `deviceId` string - `environment` string - `id` string - `semanticVersion` string - `sessionId` string - `type` 'migration', required - `userAgent` string - `version` string — The origin version, in whatever format the origin natively provides. - `sources` SourceProvenance[] - `authors` string[] — The people or organizations that authored the material. - `entityId` string - `firstPublished` string, date-time - `lastUpdated` string, date-time - `loadedAt` string, date-time - `location` Location — A location where the source material can be found. - `description` string — Encapsulates a message intended to be read by the end user. - `name` string — A string containing the name of the location. - `uri` string, uri — A string containing a valid relative or absolute URI. - `type` 'webpage' | 'document' | 'integration', required — The type of source material which was used to produce a value. - `schema` EntityType, required — unresolved $ref ## Response `200` The metadata of the created entity type - union - object - `provenance` OntologyProvenance, required — Provenance information for an ontology type. Contains tracking information about the creation, modification, and origin of an ontology type. - `edition` OntologyEditionProvenance, required — Provenance information for a specific edition of an ontology type. Contains comprehensive tracking of who created and potentially archived this edition, along with user-provided context about the creation process. - `actorType` 'user' | 'machine' | 'ai', required — Types of individual actors in the system. Represents the different categories of entities that can perform actions. - `origin` union, required - object - `apiKeyPublicId` string - `deviceId` string - `environment` string - `id` string - `semanticVersion` string - `sessionId` string - `type` 'web-app', required - `userAgent` string - `version` string — The origin version, in whatever format the origin natively provides. - object - `apiKeyPublicId` string - `deviceId` string - `environment` string - `id` string - `semanticVersion` string - `sessionId` string - `type` 'mobile-app', required - `userAgent` string - `version` string — The origin version, in whatever format the origin natively provides. - object - `apiKeyPublicId` string - `deviceId` string - `environment` string - `id` string - `semanticVersion` string - `sessionId` string - `type` 'browser-extension', required - `userAgent` string - `version` string — The origin version, in whatever format the origin natively provides. - object - `apiKeyPublicId` string - `deviceId` string - `environment` string - `id` string - `semanticVersion` string - `sessionId` string - `type` 'api', required - `userAgent` string - `version` string — The origin version, in whatever format the origin natively provides. - object - `apiKeyPublicId` string - `deviceId` string - `environment` string - `id` string - `semanticVersion` string - `sessionId` string - `stepIds` string[] - `type` 'flow', required - `userAgent` string - `version` string — The origin version, in whatever format the origin natively provides. - object - `apiKeyPublicId` string - `deviceId` string - `environment` string - `id` string - `semanticVersion` string - `sessionId` string - `type` 'migration', required - `userAgent` string - `version` string — The origin version, in whatever format the origin natively provides. - `sources` SourceProvenance[] - `authors` string[] — The people or organizations that authored the material. - `entityId` string - `firstPublished` string, date-time - `lastUpdated` string, date-time - `loadedAt` string, date-time - `location` Location — A location where the source material can be found. - `description` string — Encapsulates a message intended to be read by the end user. - `name` string — A string containing the name of the location. - `uri` string, uri — A string containing a valid relative or absolute URI. - `type` 'webpage' | 'document' | 'integration', required — The type of source material which was used to produce a value. - `archivedById` string, uuid - `createdById` string, uuid, required - `recordId` OntologyTypeRecordId, required — An identifier for an ontology type record consisting of a base URL and version. This type provides a structured representation of an ontology type identifier that can be used in database records and type definitions. It contains the same components as a [`VersionedUrl`] but in a structured form rather than a string. # Examples ``` use std::str::FromStr; use type_system::ontology::id::{ BaseUrl, OntologyTypeRecordId, OntologyTypeVersion, VersionedUrl, }; // Create from individual components let base_url = BaseUrl::new("https://example.com/types/data-type/text/".to_owned())?; let version = OntologyTypeVersion::from_str("1")?; let record_id = OntologyTypeRecordId { base_url, version }; // Convert between VersionedUrl and OntologyTypeRecordId let url = VersionedUrl::from_str("https://example.com/types/data-type/text/v/1")?; let record_id = OntologyTypeRecordId::from(url.clone()); let url2 = VersionedUrl::from(record_id); assert_eq!(url, url2); # Ok::<(), Box>(()) ``` - `baseUrl` string, uri, required — The base URL of a Block Protocol ontology type (the $id of the schema, without the versioned suffix). It should be a valid URL, with a trailing slash. - `version` string, required - `temporalVersioning` OntologyTemporalMetadata, required - `transactionTime` LeftClosedTemporalInterval, required - `end` union, required - object - `kind` 'exclusive', required - `limit` string, date-time, required - object - `kind` 'unbounded', required - `start` ClosedTemporalBound, required - `kind` 'inclusive', required - `limit` string, date-time, required - `webId` string, uuid, required - object - `fetchedAt` string, date-time, required - `provenance` OntologyProvenance, required — Provenance information for an ontology type. Contains tracking information about the creation, modification, and origin of an ontology type. - `edition` OntologyEditionProvenance, required — Provenance information for a specific edition of an ontology type. Contains comprehensive tracking of who created and potentially archived this edition, along with user-provided context about the creation process. - `actorType` 'user' | 'machine' | 'ai', required — Types of individual actors in the system. Represents the different categories of entities that can perform actions. - `origin` union, required - object - `apiKeyPublicId` string - `deviceId` string - `environment` string - `id` string - `semanticVersion` string - `sessionId` string - `type` 'web-app', required - `userAgent` string - `version` string — The origin version, in whatever format the origin natively provides. - object - `apiKeyPublicId` string - `deviceId` string - `environment` string - `id` string - `semanticVersion` string - `sessionId` string - `type` 'mobile-app', required - `userAgent` string - `version` string — The origin version, in whatever format the origin natively provides. - object - `apiKeyPublicId` string - `deviceId` string - `environment` string - `id` string - `semanticVersion` string - `sessionId` string - `type` 'browser-extension', required - `userAgent` string - `version` string — The origin version, in whatever format the origin natively provides. - object - `apiKeyPublicId` string - `deviceId` string - `environment` string - `id` string - `semanticVersion` string - `sessionId` string - `type` 'api', required - `userAgent` string - `version` string — The origin version, in whatever format the origin natively provides. - object - `apiKeyPublicId` string - `deviceId` string - `environment` string - `id` string - `semanticVersion` string - `sessionId` string - `stepIds` string[] - `type` 'flow', required - `userAgent` string - `version` string — The origin version, in whatever format the origin natively provides. - object - `apiKeyPublicId` string - `deviceId` string - `environment` string - `id` string - `semanticVersion` string - `sessionId` string - `type` 'migration', required - `userAgent` string - `version` string — The origin version, in whatever format the origin natively provides. - `sources` SourceProvenance[] - `authors` string[] — The people or organizations that authored the material. - `entityId` string - `firstPublished` string, date-time - `lastUpdated` string, date-time - `loadedAt` string, date-time - `location` Location — A location where the source material can be found. - `description` string — Encapsulates a message intended to be read by the end user. - `name` string — A string containing the name of the location. - `uri` string, uri — A string containing a valid relative or absolute URI. - `type` 'webpage' | 'document' | 'integration', required — The type of source material which was used to produce a value. - `archivedById` string, uuid - `createdById` string, uuid, required - `recordId` OntologyTypeRecordId, required — An identifier for an ontology type record consisting of a base URL and version. This type provides a structured representation of an ontology type identifier that can be used in database records and type definitions. It contains the same components as a [`VersionedUrl`] but in a structured form rather than a string. # Examples ``` use std::str::FromStr; use type_system::ontology::id::{ BaseUrl, OntologyTypeRecordId, OntologyTypeVersion, VersionedUrl, }; // Create from individual components let base_url = BaseUrl::new("https://example.com/types/data-type/text/".to_owned())?; let version = OntologyTypeVersion::from_str("1")?; let record_id = OntologyTypeRecordId { base_url, version }; // Convert between VersionedUrl and OntologyTypeRecordId let url = VersionedUrl::from_str("https://example.com/types/data-type/text/v/1")?; let record_id = OntologyTypeRecordId::from(url.clone()); let url2 = VersionedUrl::from(record_id); assert_eq!(url, url2); # Ok::<(), Box>(()) ``` - `baseUrl` string, uri, required — The base URL of a Block Protocol ontology type (the $id of the schema, without the versioned suffix). It should be a valid URL, with a trailing slash. - `version` string, required - `temporalVersioning` OntologyTemporalMetadata, required - `transactionTime` LeftClosedTemporalInterval, required - `end` union, required - object - `kind` 'exclusive', required - `limit` string, date-time, required - object - `kind` 'unbounded', required - `start` ClosedTemporalBound, required - `kind` 'inclusive', required - `limit` string, date-time, required ## Other responses - `400` — Provided request body is invalid - `409` — Unable to load entity type in the datastore as the entity type ID already exists - `500` — Store error occurred ## Changes - **2026-06-25** `d94249d1f3aa` — 1 warning - the `oneOf[subschema #1]/entityTypeId` request property's maxLength was set to `2048` - **2025-12-17** `2e2aef91c0ff` — 2 warning, 1 info - added the new `integration` enum value to the `oneOf[subschema #1: OwnedEntityTypeMetadata]/provenance/edition/allOf[#/components/schemas/ProvidedOntologyEditionProvenance]/sources/items/type` response property for the response status `200` - added the new `integration` enum value to the `oneOf[subschema #2: ExternalEntityTypeMetadata]/provenance/edition/allOf[#/components/schemas/ProvidedOntologyEditionProvenance]/sources/items/type` response property for the response status `200` - added the new `integration` enum value to the request property `oneOf[subschema #2]/provenance/sources/items/type` - **2025-07-21** `5c112ed1e30a` — 1 warning - removed the request property `oneOf[subschema #2]/relationships` - **2025-07-09** `727ca7d0a69e` — 1 info - added `subschema #5` to the `oneOf[subschema #2]/relationships/items/` request property `oneOf` list - **2025-05-20** `19e6d5ddecee` — 1 breaking - removed `subschema #5` from the `oneOf[subschema #2]/relationships/items/` request property `oneOf` list [Full history](https://skmtc.dev/hashintel/apis/graph/changes/entity-types/load/post.md) --- [API](https://skmtc.dev/hashintel/apis/graph.md) · [All operations](https://skmtc.dev/hashintel/apis/graph/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hashintel/graph/revisions/ba95e69ddba8/schema)