Skip to main content
POST
/
v1
/
indexes
/
describe
Get Index Name
curl --request POST \
  --url https://api.example.com/v1/indexes/describe

Documentation Index

Fetch the complete documentation index at: https://docs.cyborg.co/llms.txt

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

Extract the index name from the describe response. This represents the identifier of the currently described index.

​
Request Body

{
  "index_name": "my_index",
  "index_key": "64_character_hex_string_representing_32_bytes"
}

​
Response

The response contains the index name in the index_name field: 
{
  "index_name": "my_index"
}

​
Example Usage

# Retrieve the index name
index_name=$(curl -s -X POST "http://localhost:8000/v1/indexes/describe" \
     -H "X-API-Key: cyborg_your_api_key_here" \
     -H "Content-Type: application/json" \
     -d '{
       "index_name": "my_index",
       "index_key": "your_64_character_hex_key_here"  
     }' | jq -r '.index_name')

echo "Current index name: $index_name"