# Aleph Alpha Transformations API

**Canonical:** https://apis.io/apis/aleph-alpha/aleph-alpha-transformations-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 Transformations 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 Transformation. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

Available transformations can be applied to an input data object of type A to produce an output data object of type B. The output data object will consist of a sequence of items, each of which will conform to an Avro schema specified in the transformation as OutputSchema. Currently, the input data object can be a File located in a Stage within the Data Platform. Future versions will support receiving Datasets from Repositories in the Data Platform as input data objects. The output data object can be loaded into various types of data storage within the Data Platform, with Repositories being the first supported storage type. When triggering a transformation, this has to be specified as destination. After loading the output into the destination, it can also be sent to an external service through available connectors in the Data Platform. The first available connector will be the Document Index Collection Connector.

## Operations (7)

| Method | Path | Summary |
|---|---|---|
| GET | `/transformations` | Retrieve a list of available transformations |
| GET | `/transformations/{transformationID}` | Retrieve transformation details by ID |
| POST | `/transformations/{transformationID}/runs` | Trigger a transformation |
| GET | `/transformations/{transformationID}/runs` | Retrieve a list of created runs given a transformation ID |
| GET | `/transformations/{transformationID}/runs/events` | Stream real-time run updates for a transformation |
| GET | `/transformations/{transformationID}/runs/{runID}` | Retrieve transformation run details by ID |
| POST | `/transformations/{transformationID}/runs/batch` | Trigger multiple transformations in batch |

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/aleph-alpha/refs/heads/main/openapi/aleph-alpha-transformations-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

Transformation

---

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