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

# POST /entities/embeddings

`POST /entities/embeddings`

## Headers

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

## Request body

- UpdateEntityEmbeddingsParams
  - `embeddings` EntityEmbedding[], required
    - `embedding` number[], required
    - `property` string, uri — 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.
  - `entityId` string, required
  - `reset` boolean, required
  - `updatedAtDecisionTime` string, date-time, required
  - `updatedAtTransactionTime` string, date-time, required

## Response `204`

The embeddings were created

## Other responses

- `403` — Insufficient permissions to update the entity
- `500` — Store error occurred

## Changes

- **2026-06-25** `d94249d1f3aa` — 1 warning
  - the `embeddings/items/property/allOf[#/components/schemas/BaseUrl -> subschema #1: Base URL]/` request property's maxLength was set to `2048`

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