---
title: "Changes to Get Embeddings. Returns a 424 status code if the model is not an embedding model."
method: POST
path: "/embed"
---

# Changes to Get Embeddings. Returns a 424 status code if the model is not an embedding model.

`POST /embed`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 4 of 42 revisions.

- **2025-09-01** `9988d0e89620` — 4 warning, 2 info
- **2024-06-28** `b923798e3868` — 1 breaking, 4 info
- **2023-11-15** `c4554b0fed8e` — 1 info
- **2023-10-13** `8c00768ef703` — 2 breaking, 4 warning, 6 info

## Changes

- **2025-09-01** `9988d0e89620` — 4 warning, 2 info
  - added the new `Empty` enum value to the `error_type` response property for the response status `413`
  - added the new `Empty` enum value to the `error_type` response property for the response status `422`
  - added the new `Empty` enum value to the `error_type` response property for the response status `424`
  - added the new `Empty` enum value to the `error_type` response property for the response status `429`
  - added the new optional request property `dimensions`
  - added the non-success response with the status `400`
- **2024-06-28** `b923798e3868` — 1 breaking, 4 info
  - removed `subschema #1, subschema #2` from the `inputs` request property `oneOf` list
  - added the new optional request property `prompt_name`
  - added the new optional request property `truncation_direction`
  - the request property `truncate` became nullable
  - added `#/components/schemas/InputType, subschema #2` to the `inputs` request property `oneOf` list
- **2023-11-15** `c4554b0fed8e` — 1 info
  - added the new optional request property `normalize`
- **2023-10-13** `8c00768ef703` — 2 breaking, 4 warning, 6 info
  - the request property `truncate` became not nullable
  - removed `#/components/schemas/InputType, subschema #2` from the `inputs` request property `oneOf` list
  - removed the request property `dimensions`
  - removed the request property `normalize`
  - removed the request property `prompt_name`
  - removed the request property `truncation_direction`
  - added `subschema #1, subschema #2` to the `inputs` request property `oneOf` list
  - removed the non-success response with the status `400`
  - removed the `Empty` enum value from the `error_type` response property for the response status `413`
  - removed the `Empty` enum value from the `error_type` response property for the response status `422`
  - removed the `Empty` enum value from the `error_type` response property for the response status `424`
  - removed the `Empty` enum value from the `error_type` response property for the response status `429`

---

[Operation](https://skmtc.dev/huggingface/apis/text-embeddings-inference/docs/embed/post.md) · [API](https://skmtc.dev/huggingface/apis/text-embeddings-inference.md) · [Page](https://skmtc.dev/huggingface/apis/text-embeddings-inference/changes/embed/post)