> ## Documentation Index
> Fetch the complete documentation index at: https://docs.e6data.com/llms.txt
> Use this file to discover all available pages before exploring further.

# HTTP API

> Use HTTP to query data, save workloads, run notebooks, refresh dashboards, manage catalogs, and inspect execution. The same engine services handle requests from the console and fro

ExplanationApplies to: Unified engine deployments

Use HTTP to query data, save workloads, run notebooks, refresh dashboards, manage catalogs, and inspect execution. The same engine services handle requests from the console and from your own clients.

## Start here

1. [Make your first request](https://docs.e6data.com/transformation/http/first-request.md) to discover this instance.
2. [Query inline orders](https://docs.e6data.com/transformation/http/examples/query-orders.md) to open a session, submit SQL, and read real results.
3. [Create and run a workload](https://docs.e6data.com/transformation/http/examples/workload.md) to save a task graph and follow a run.
4. Browse the [complete API reference](https://docs.e6data.com/transformation/http/reference.md) for every public operation.

Read the endpoint description and parameters beside its request and response examples. Copy request examples into your own client.

## Choose an API area

| Area | What you can do |
| - | - |
| Sessions and SQL | Analyze and execute SQL, follow attempts, cancel, and fetch results. |
| Workloads | Save graphs, schedule, start runs, inspect tasks, rerun, backfill, and read notifications. |
| Catalogs and tables | Validate connections, discover relations, inspect tables, and perform supported metadata actions. |
| Notebooks | Manage documents, revisions, sessions, runs, and cell outputs. |
| Dashboards | Save definitions, preview, activate, refresh, inspect snapshots, and fetch dataset results. |
| Workspace documents | Save reusable queries and supported workspace documents. |
| Compute and workers | Discover execution options, inspect workers, and change deployment profiles or admission. |
| Observability | Read activity, audit, retained telemetry, metrics, and query Xray. |
| Configuration and capabilities | Discover enabled services and validate or save configuration changes. |
| Assistant | Manage conversations and turns, watch events, and approve or cancel actions. |

Secrets, credentials, native streaming pipelines, and SQL table maintenance use SQL through session operations. See [SQL-managed features](https://docs.e6data.com/transformation/http/sql-managed-features.md) for complete request flows.

## Read and run examples

Complete examples show requests in order. Copy requests into your own client and replace the placeholders with your deployment values. Keep returned IDs for later steps. Repeat status reads until execution reaches a final state. Decode Arrow results with a compatible client.

Saved resources and started work remain in the engine after you leave the documentation.

## Download the contract

[Download the OpenAPI contract](https://docs.e6data.com/openapi/transformation.json).

The OpenAPI document is generated from the HTTP endpoint inventory, shared input schemas, and Rust response DTOs. Examples are illustrative; inspect your engine's actual response in your client.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.