--- title: "PUT /data-types/bulk" method: PUT path: "/data-types/bulk" tags: ["Graph", "DataType"] --- # PUT /data-types/bulk `PUT /data-types/bulk` ## Headers - `X-Authenticated-User-Actor-Id` string, uuid, required ## Request body - UpdateDataTypeRequest[] - `conversions` object, required - `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` UpdateDataType, required — unresolved $ref - `typeToUpdate` 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}` ## Response `200` The metadata of the updated data types - DataTypeMetadata[] - union - object - `conversions` 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 - … - object - … - object - … - object - … - object - … - object - … - `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. - … - `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 - … - object - … - `start` ClosedTemporalBound, required - `kind` 'inclusive', required - `limit` string, date-time, required - `webId` string, uuid, required - object - `conversions` 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 - … - object - … - object - … - object - … - object - … - object - … - `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. - … - `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 - … - object - … - `start` ClosedTemporalBound, required - `kind` 'inclusive', required - `limit` string, date-time, required ## Other responses - `404` — Base data types ID were not found - `422` — Provided request body is invalid - `500` — Store error occurred ## Changes - **2026-06-25** `d94249d1f3aa` — 1 warning - the `items/typeToUpdate` request property's maxLength was set to `2048` - **2025-12-17** `2e2aef91c0ff` — 2 warning, 1 info - added the new `integration` enum value to the `items/oneOf[subschema #1: OwnedDataTypeMetadata]/provenance/edition/allOf[#/components/schemas/ProvidedOntologyEditionProvenance]/sources/items/type` response property for the response status `200` - added the new `integration` enum value to the `items/oneOf[subschema #2: ExternalDataTypeMetadata]/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 `items/provenance/sources/items/type` - **2025-07-21** `5c112ed1e30a` — 1 warning - removed the request property `items/relationships` - **2025-05-09** `ab5d80da9faf` — 2 breaking - the `items/oneOf[subschema #1: OwnedDataTypeMetadata]/recordId/version` response's property type/format changed from `integer`/`int32` to `string`/`` for status `200` - the `items/oneOf[subschema #2: ExternalDataTypeMetadata]/recordId/version` response's property type/format changed from `integer`/`int32` to `string`/`` for status `200` - …earlier changes not shown [Full history](https://skmtc.dev/hashintel/apis/graph/changes/data-types/bulk/put.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)