Document Indexes

Retrieve

Beta
GET
Used to retrieve a Document Index given its ID or name.

Path parameters

idstringRequired
Either the Document Index's ID or its unique name

Response

This endpoint returns an object
id
string
created
datetime
label
string
A human-readable label for the document index
name
string
A name that uniquely identifies this index within its workspace
indexing_config
object
status
enumOptional

The current status of the document index

  • ACTIVE - Active
  • ARCHIVED - Archived
Allowed values: ACTIVEARCHIVED
environment
enumOptional

The environment this document index is used in

  • DEVELOPMENT - Development
  • STAGING - Staging
  • PRODUCTION - Production
Allowed values: DEVELOPMENTSTAGINGPRODUCTION
GET
1curl https://api.vellum.ai/v1/document-indexes/:id \
2 -H "X_API_KEY: <apiKey>"
200Retrieved
1{
2 "id": "string",
3 "created": "2023-01-01T00:00:00Z",
4 "label": "string",
5 "name": "string",
6 "indexing_config": {
7 "vectorizer": {
8 "model_name": "text-embedding-3-small",
9 "config": {
10 "add_openai_api_key": true
11 }
12 },
13 "chunking": {
14 "chunker_name": "reducto-chunker",
15 "chunker_config": {
16 "character_limit": 0
17 }
18 }
19 },
20 "status": "ACTIVE",
21 "environment": "DEVELOPMENT"
22}