Skip to main content
POST
/
v1
/
index
curl --location --request POST 'https://api.getmetal.io/v1/index' \
--header 'Content-Type: application/json' \
--header 'x-metal-api-key: <api-key>' \
--header 'x-metal-client-id: <client-id>' \
--data-raw '{
    "index": "index-id",
    "text": "text that will replace the existing document",
    "id": "id-to-update",
    "metadata": {
        "fieldA": "my custom value"
    }
}'

{
  "id": "id-to-update",
  "text": "text that will replace the existing document",
  "createdAt": "2023-03-17T17:21:13.163Z",
  "metadata": {
    "fieldA": "my custom value"
  }

}

Documentation Index

Fetch the complete documentation index at: https://docs.getmetal.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Auth Headers

​
x-metal-api-key
string
required
An API key for your org.
​
x-metal-client-id
string
required
A Client ID for your org.

​
Body

​
index
string
required
Index ID
​
id
string
required
Existing Document ID to update. Must be between 3 - 256 chars and consist of numbers, letters, or -.
​
text
string
Text to be embedded. Must be between 3 - 10,000 chars.
​
imageUrl
string
Image URL
​
embedding
number[]
Custom Embeddings
​
metadata
object
Metadata object.
curl --location --request POST 'https://api.getmetal.io/v1/index' \
--header 'Content-Type: application/json' \
--header 'x-metal-api-key: <api-key>' \
--header 'x-metal-client-id: <client-id>' \
--data-raw '{
    "index": "index-id",
    "text": "text that will replace the existing document",
    "id": "id-to-update",
    "metadata": {
        "fieldA": "my custom value"
    }
}'

{
  "id": "id-to-update",
  "text": "text that will replace the existing document",
  "createdAt": "2023-03-17T17:21:13.163Z",
  "metadata": {
    "fieldA": "my custom value"
  }

}