Collections APICollections API Reference

Collection Management

The base URL for collection management is shared with Management API at https://management-api.x.ai/. You have to authenticate using xAI Management API Key with the header Authorization: Bearer <your xAI Management API key>.

For more details on provisioning xAI Management API key and using Management API, you can visit


POST /v1/collections

API endpoint for POST requests to /v1/collections.

Method: POST
Path: /v1/collections

GET /v1/collections

API endpoint for GET requests to /v1/collections.

Method: GET
Path: /v1/collections

GET /v1/collections/{collection_id}

API endpoint for GET requests to /v1/collections/{collection_id}.

Method: GET
Path: /v1/collections/{collection_id}

DELETE /v1/collections/{collection_id}

API endpoint for DELETE requests to /v1/collections/{collection_id}.

Method: DELETE
Path: /v1/collections/{collection_id}

PUT /v1/collections/{collection_id}

API endpoint for PUT requests to /v1/collections/{collection_id}.

Method: PUT
Path: /v1/collections/{collection_id}

POST /v1/collections/{collection_id}/documents/{file_id}

API endpoint for POST requests to /v1/collections/{collection_id}/documents/{file_id}.

Method: POST
Path: /v1/collections/{collection_id}/documents/{file_id}

GET /v1/collections/{collection_id}/documents

API endpoint for GET requests to /v1/collections/{collection_id}/documents.

Method: GET
Path: /v1/collections/{collection_id}/documents

GET /v1/collections/{collection_id}/documents/{file_id}

API endpoint for GET requests to /v1/collections/{collection_id}/documents/{file_id}.

Method: GET
Path: /v1/collections/{collection_id}/documents/{file_id}

PATCH /v1/collections/{collection_id}/documents/{file_id}

API endpoint for PATCH requests to /v1/collections/{collection_id}/documents/{file_id}.

Method: PATCH
Path: /v1/collections/{collection_id}/documents/{file_id}

DELETE /v1/collections/{collection_id}/documents/{file_id}

API endpoint for DELETE requests to /v1/collections/{collection_id}/documents/{file_id}.

Method: DELETE
Path: /v1/collections/{collection_id}/documents/{file_id}

GET /v1/collections/{collection_id}/documents:batchGet

API endpoint for GET requests to /v1/collections/{collection_id}/documents:batchGet.

Method: GET
Path: /v1/collections/{collection_id}/documents:batchGet