# xAI Files API

**Canonical:** https://apis.io/apis/xai/xai-files-api/  
**Provider:** xAI — https://apis.io/providers/xai/  
**Base URL:** https://api.x.ai/v1  
**Documentation:** https://docs.x.ai/docs/api-reference

xAI Files API is one of 17 APIs that [xAI](https://apis.io/providers/xai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification. Tagged areas include File. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and an AsyncAPI specification.

The Files API from xAI — 3 operation(s) for files.

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/files` | List files owned by the authenticated team, paginated. |
| POST | `/v1/files` | Upload a file to xAI's storage. |
| GET | `/v1/files/{file_id}` | Retrieve metadata for a single file by ID. |
| DELETE | `/v1/files/{file_id}` | Delete a file by ID. |
| GET | `/v1/files/{file_id}/content` | Download the contents of a file as a stream of raw bytes. |

## Machine-readable artifacts (12)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/xai/refs/heads/main/openapi/xai-files-api-openapi.yml
- **Documentation** — https://docs.x.ai/docs/overview
- **APIReference** — https://docs.x.ai/docs/api-reference#chat-completions
- **Documentation** — https://docs.x.ai/docs/api-reference#responses
- **Documentation** — https://docs.x.ai/docs/guides/image-generations
- **APIReference** — https://docs.x.ai/docs/api-reference#image-generations
- **Documentation** — https://docs.x.ai/docs/guides/video-generation
- **Documentation** — https://docs.x.ai/docs/guides/voice
- **AsyncAPI** — https://raw.githubusercontent.com/api-evangelist/xai/refs/heads/main/asyncapi/xai-asyncapi.yml
- **Documentation** — https://docs.x.ai/docs/guides/embeddings
- **Documentation** — https://docs.x.ai/docs/api-reference#models
- **Documentation** — https://docs.x.ai/docs/guides/batch

## Other xAI APIs (12)

- [xAI Api Key API](https://apis.io/apis/xai/xai-api-key-api/)
- [xAI Chat API](https://apis.io/apis/xai/xai-chat-api/)
- [xAI Complete API](https://apis.io/apis/xai/xai-complete-api/)
- [xAI Completions API](https://apis.io/apis/xai/xai-completions-api/)
- [xAI Documents API](https://apis.io/apis/xai/xai-documents-api/)
- [xAI Embedding Models API](https://apis.io/apis/xai/xai-embedding-models-api/)
- [xAI Embeddings API](https://apis.io/apis/xai/xai-embeddings-api/)
- [xAI Image Generation Models API](https://apis.io/apis/xai/xai-image-generation-models-api/)
- [xAI Images API](https://apis.io/apis/xai/xai-images-api/)
- [xAI Language Models API](https://apis.io/apis/xai/xai-language-models-api/)
- [xAI Messages API](https://apis.io/apis/xai/xai-messages-api/)
- [xAI Models API](https://apis.io/apis/xai/xai-models-api/)

## Tags

File

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/xai/xai-files-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/xai/.
