# Aleph Alpha Stages API

**Canonical:** https://apis.io/apis/aleph-alpha/aleph-alpha-stages-api/  
**Provider:** Aleph Alpha — https://apis.io/providers/aleph-alpha/  
**Base URL:** https://api.aleph-alpha.com  
**Documentation:** https://docs.aleph-alpha.com/phariaai-dev-guide/latest/pharia-openapi/pharia-inference/index.html

Aleph Alpha Stages API is one of 37 APIs that [Aleph Alpha](https://apis.io/providers/aleph-alpha/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Stages. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

Stages serve as the data platform's entry point for data collection, where source files are securely stored, enabling subsequent transformations and dataset generation. Files can be uploaded directly into stages via the HTTP API or through connectors, which support automated and continuous synchronization with your source systems. Stages provide secure, persistent storage and act as an interface for importing and exporting data files within the platform. To improve data discoverability, comprehension, and quality for end users, the data platform offers datasets as the recommended abstraction for organizing and sharing data.

## Operations (13)

| Method | Path | Summary |
|---|---|---|
| GET | `/stages` | Retrieve a list of stages |
| POST | `/stages` | Create a new stage |
| GET | `/stages/{stageID}` | Retrieve stage details by ID |
| DELETE | `/stages/{stageID}` | Delete a specific stage |
| PATCH | `/stages/{stageID}` | Update Stage Configuration |
| GET | `/stages/{stageID}/runs` | Retrieve a list of runs for a stage |
| GET | `/stages/{stageID}/runs/events` | Stream real-time run updates for a stage |
| GET | `/stages/{stageID}/files` | Retrieve a list of files in a stage |
| POST | `/stages/{stageID}/files` | Create a new file in a stage |
| GET | `/stages/{stageID}/files/{fileID}` | Retrieve the content of a specific file |
| PUT | `/stages/{stageID}/files/{fileID}` | Update an existing file in a stage |
| DELETE | `/stages/{stageID}/files/{fileID}` | Permanently delete a specific file |
| GET | `/stages/{stageID}/files/{fileID}/presigned-url` | Get a presigned URL for a file |

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/aleph-alpha/refs/heads/main/openapi/aleph-alpha-stages-api-openapi.yml
- **Documentation** — https://docs.aleph-alpha.com/phariaai-dev-guide/latest/pharia-openapi/pharia-inference/v4.7.0.html
- **Documentation** — https://docs.aleph-alpha.com/phariaai-dev-guide/latest/responses-api/index.html

## Other Aleph Alpha APIs (12)

- [Aleph Alpha API description API](https://apis.io/apis/aleph-alpha/aleph-alpha-api-description-api/)
- [Aleph Alpha Application Traces API](https://apis.io/apis/aleph-alpha/aleph-alpha-application-traces-api/)
- [Aleph Alpha Benchmark Executions API](https://apis.io/apis/aleph-alpha/aleph-alpha-benchmark-executions-api/)
- [Aleph Alpha Benchmarks API](https://apis.io/apis/aleph-alpha/aleph-alpha-benchmarks-api/)
- [Aleph Alpha Cluster API](https://apis.io/apis/aleph-alpha/aleph-alpha-cluster-api/)
- [Aleph Alpha Collection API](https://apis.io/apis/aleph-alpha/aleph-alpha-collection-api/)
- [Aleph Alpha Connectors API](https://apis.io/apis/aleph-alpha/aleph-alpha-connectors-api/)
- [Aleph Alpha Conversations API](https://apis.io/apis/aleph-alpha/aleph-alpha-conversations-api/)
- [Aleph Alpha Datasets API](https://apis.io/apis/aleph-alpha/aleph-alpha-datasets-api/)
- [Aleph Alpha Document API](https://apis.io/apis/aleph-alpha/aleph-alpha-document-api/)
- [Aleph Alpha Downloads API](https://apis.io/apis/aleph-alpha/aleph-alpha-downloads-api/)
- [Aleph Alpha Evaluation Datasets API](https://apis.io/apis/aleph-alpha/aleph-alpha-evaluation-datasets-api/)

## Tags

Stages

---

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