---
title: "POST /entities/validate"
method: POST
path: "/entities/validate"
tags: ["Graph", "Entity"]
---

# POST /entities/validate

`POST /entities/validate`

## Headers

- `X-Authenticated-User-Actor-Id` string, uuid, required

## Request body

- ValidateEntityParams
  - `components` ValidateEntityComponents
    - `linkData` boolean
    - `linkValidation` boolean
    - `numItems` boolean
    - `requiredProperties` boolean
  - `entityTypes` VersionedUrl[], required
  - `linkData` LinkData — The associated information for 'Link' entities.
    - `leftEntityConfidence` number, double
    - `leftEntityId` string, required
    - `leftEntityProvenance` PropertyProvenance
      - `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.
    - `rightEntityConfidence` number, double
    - `rightEntityId` string, required
    - `rightEntityProvenance` PropertyProvenance
      - `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.
  - `properties` PropertyObjectWithMetadata, required
    - `metadata` ObjectMetadata
      - `confidence` number, double
      - `provenance` PropertyProvenance
        - `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.
    - `value` object, required

## Response `200`

The validation report

- object

## Other responses

- `400` — The entity validation failed
- `404` — Entity Type URL was not found
- `500` — Store error occurred

## Changes

- **2026-06-25** `d94249d1f3aa` — 1 breaking, 3 warning, 1 info
  - added `subschema #4, subschema #5, subschema #7` to the `additionalProperties/properties/additionalProperties/` response property `oneOf` list for the response status `200`
  - the `entityTypes/items/` request property's maxLength was set to `2048`
  - the `properties/value/additionalProperties/oneOf[#/components/schemas/PropertyValueWithMetadata]/metadata/dataTypeId/allOf[#/components/schemas/VersionedUrl -> subschema #1: Versioned URL]/` request property's maxLength was set to `2048`
  - the `properties/value/additionalProperties/oneOf[#/components/schemas/PropertyValueWithMetadata]/metadata/originalDataTypeId/allOf[#/components/schemas/VersionedUrl -> subschema #1: Versioned URL]/` request property's maxLength was set to `2048`
  - …1 more
- …earlier changes not shown

[Full history](https://skmtc.dev/hashintel/apis/graph/changes/entities/validate/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)