Trigger Embedding Bulk | Mesh API Docs

Manually enqueue embedding jobs for one or more files.

Each file must have upload_status=ready and embedding_status=pending or failed. Returns a per-file result — successes are ‘queued’, failures include an error message.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

file_idslist of stringsRequired

waitbooleanOptionalDefaults to false

metadatamap from strings to anyOptional

Response

Successful Response

resultslist of objects

Errors

422

Unprocessable Entity Error

$	curl -X POST https://api.meshapi.ai/v1/files/embed \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"file_ids": [
>	"file_123abc456def7890"
>	]
>	}'

1	{
2	"results": [
3	{
4	"file_id": "file_123abc456def7890",
5	"embedding_status": "queued",
6	"chunk_count": 12,
7	"error": ""
8	}
9	]
10	}

$	curl -X POST https://api.meshapi.ai/v1/files/embed \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"file_ids": [
>	"file_123abc456def7890"
>	]
>	}'

1	{
2	"results": [
3	{
4	"file_id": "file_123abc456def7890",
5	"embedding_status": "queued",
6	"chunk_count": 12,
7	"error": ""
8	}
9	]
10	}