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

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

`POST /similarity`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 3 of 42 revisions.

- **2025-09-01** `9988d0e89620` — 4 warning, 2 info
- **2024-07-08** `c8403e993990` — 1 info
- **2023-10-13** `8c00768ef703` — 1 breaking

## 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`
  - the request property `parameters/allOf[#/components/schemas/SimilarityParameters]/truncation_direction` became optional
  - added the non-success response with the status `400`
- **2024-07-08** `c8403e993990` — 1 info
  - endpoint added
- **2023-10-13** `8c00768ef703` — 1 breaking
  - api path removed without deprecation

---

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