---
title: "Create embeddings"
method: POST
path: "/v1/embeddings"
tags: ["embeddings"]
---

# Create embeddings

`POST /v1/embeddings`

## Request

- Base URL: `http://localhost:8080`
- URL: `http://localhost:8080/v1/embeddings`
- Auth: none declared
- TypeScript: <https://skmtc.dev/atomaai/apis/atoma-service/docs/v1/embeddings/post.ts> (a function with typed inputs; its response is checked against the schema)

This handler simply forwards the request to the embeddings service and returns the response.

# Arguments

* `state` - Application state containing service URLs
* `payload` - The embedding request body

# Returns

Returns the JSON response from the embeddings service

# Errors

Returns a `AtomaServiceError::InternalError` if:
- The embeddings service request fails
- Response parsing fails

## Request body

- unknown

## Response `200`

Embeddings generated successfully

- unknown

## Other responses

- `500`: Internal server error

---

[API](https://skmtc.dev/atomaai/apis/atoma-service.md) - [All operations](https://skmtc.dev/atomaai/apis/atoma-service/llms.txt) - [OpenAPI document](https://skmtc.dev/atomaai/apis/atoma-service/revisions/a3d329cb3125?raw)