# Prisma [Experimental] API

**Canonical:** https://apis.io/apis/prisma/prisma-experimental-api/  
**Provider:** Prisma — https://apis.io/providers/prisma/  
**Base URL:** https://api.prisma.io/v1  
**Documentation:** https://www.prisma.io/docs/rest-api

Prisma [Experimental] API is one of 29 APIs that [Prisma](https://apis.io/providers/prisma/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Experimental. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, authentication docs, and rate-limit docs.

Experimental endpoints are in active development and may change at any time without notice.

## Operations (60 of 70)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/apps` | List apps |
| POST | `/v1/apps` | Create app |
| GET | `/v1/apps/{appId}` | Get app |
| PATCH | `/v1/apps/{appId}` | Update app |
| DELETE | `/v1/apps/{appId}` | Delete app |
| POST | `/v1/apps/{appId}/promote` | Promote deployment |
| POST | `/v1/apps/{appId}/rollback` | Roll an app back to an existing deployment |
| GET | `/v1/apps/{appId}/domains` | List custom domains for an app |
| POST | `/v1/apps/{appId}/domains` | Create a custom domain |
| GET | `/v1/apps/{appId}/deployments` | List deployments |
| POST | `/v1/apps/{appId}/deployments` | Create deployment |
| GET | `/v1/services` | List services |
| POST | `/v1/services` | Create service |
| GET | `/v1/services/{serviceId}` | Get service |
| PATCH | `/v1/services/{serviceId}` | Update service |
| DELETE | `/v1/services/{serviceId}` | Delete service |
| POST | `/v1/services/{serviceId}/promote` | Promote deployment |
| POST | `/v1/services/{serviceId}/rollback` | Roll a service back to an existing deployment |
| GET | `/v1/services/{serviceId}/domains` | List custom domains for a service |
| POST | `/v1/services/{serviceId}/domains` | Create a custom domain |
| GET | `/v1/services/{serviceId}/deployments` | List deployments |
| POST | `/v1/services/{serviceId}/deployments` | Create deployment |
| POST | `/v1/projects/{projectId}/branches` | Create a branch |
| GET | `/v1/projects/{projectId}/branches` | List branches in a project |
| GET | `/v1/branches/{branchId}` | Get a branch |
| PATCH | `/v1/branches/{branchId}` | Update a branch |
| DELETE | `/v1/branches/{branchId}` | Soft-delete a branch |
| POST | `/v1/builds` | Report a build |
| GET | `/v1/builds` | List builds |
| PATCH | `/v1/builds/{buildId}` | Update a build |
| GET | `/v1/builds/{buildId}` | Get a build |
| PUT | `/v1/builds/{buildId}/resources/{resourceType}/{resourceId}` | Report a resource a build acted on |
| GET | `/v1/builds/{buildId}/logs` | Stream build logs |
| GET | `/v1/domains/{domainId}` | Get a custom domain |
| DELETE | `/v1/domains/{domainId}` | Delete a custom domain |
| POST | `/v1/domains/{domainId}/retry` | Retry custom domain provisioning |
| GET | `/v1/deployments/{deploymentId}` | Get deployment |
| DELETE | `/v1/deployments/{deploymentId}` | Delete deployment |
| POST | `/v1/deployments/{deploymentId}/start` | Start deployment |
| POST | `/v1/deployments/{deploymentId}/stop` | Stop deployment |
| GET | `/v1/deployments/{deploymentId}/logs` | Get deployment logs |
| POST | `/v1/projects/{projectId}/branches/{branchId}/alchemy-state/lease` | Acquire Alchemy deploy lease |
| PATCH | `/v1/projects/{projectId}/branches/{branchId}/alchemy-state/lease` | Heartbeat Alchemy deploy lease |
| DELETE | `/v1/projects/{projectId}/branches/{branchId}/alchemy-state/lease` | Release Alchemy deploy lease |
| GET | `/v1/projects/{projectId}/branches/{branchId}/alchemy-state/version` | Alchemy state store version |
| GET | `/v1/projects/{projectId}/branches/{branchId}/alchemy-state/state/stacks` | List Alchemy stacks |
| GET | `/v1/projects/{projectId}/branches/{branchId}/alchemy-state/state/stacks/{stack}/stages` | List Alchemy stages |
| GET | `/v1/projects/{projectId}/branches/{branchId}/alchemy-state/state/stacks/{stack}/stages/{stage}/resources` | List Alchemy resources |
| GET | `/v1/projects/{projectId}/branches/{branchId}/alchemy-state/state/stacks/{stack}/stages/{stage}/resources/{fqn}` | Get Alchemy resource state |
| PUT | `/v1/projects/{projectId}/branches/{branchId}/alchemy-state/state/stacks/{stack}/stages/{stage}/resources/{fqn}` | Set Alchemy resource state |
| DELETE | `/v1/projects/{projectId}/branches/{branchId}/alchemy-state/state/stacks/{stack}/stages/{stage}/resources/{fqn}` | Delete Alchemy resource state |
| GET | `/v1/projects/{projectId}/branches/{branchId}/alchemy-state/state/stacks/{stack}/stages/{stage}/replaced-resources` | List replaced Alchemy resources |
| GET | `/v1/projects/{projectId}/branches/{branchId}/alchemy-state/state/stacks/{stack}/stages/{stage}/output` | Get Alchemy stack output |
| PUT | `/v1/projects/{projectId}/branches/{branchId}/alchemy-state/state/stacks/{stack}/stages/{stage}/output` | Set Alchemy stack output |
| DELETE | `/v1/projects/{projectId}/branches/{branchId}/alchemy-state/state/stacks/{stack}` | Delete Alchemy stack state |
| PUT | `/v1/projects/{projectId}/branches/{branchId}/application-topology` | Replace branch topology |
| GET | `/v1/projects/{projectId}/branches/{branchId}/application-topology` | Get branch topology |
| POST | `/v1/environment-variables` | Create an environment variable |
| GET | `/v1/environment-variables` | List environment variables |
| PATCH | `/v1/environment-variables/{envVarId}` | Update an environment variable's value |

…and 10 more operations. They are listed in full on the page.

## Machine-readable artifacts (13)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/prisma/refs/heads/main/openapi/prisma-experimental-api-openapi.yml
- **Documentation** — https://www.prisma.io/docs/rest-api
- **APIReference** — https://api.prisma.io/v1/swagger-editor
- **GettingStarted** — https://www.prisma.io/docs/rest-api/getting-started
- **Authentication** — https://www.prisma.io/docs/rest-api/authentication
- **SDKs** — https://www.prisma.io/docs/rest-api/sdk
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/prisma/refs/heads/main/data-model/prisma-data-model.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/prisma/refs/heads/main/errors/prisma-problem-types.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/prisma/refs/heads/main/conventions/prisma-conventions.yml
- **Idempotency** — https://raw.githubusercontent.com/api-evangelist/prisma/refs/heads/main/conventions/prisma-conventions.yml
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/prisma/refs/heads/main/rate-limits/prisma-rate-limits.yml
- **OAuthScopes** — https://raw.githubusercontent.com/api-evangelist/prisma/refs/heads/main/scopes/prisma-scopes.yml
- **ToolCrosswalk** — https://raw.githubusercontent.com/api-evangelist/prisma/refs/heads/main/mcp/prisma-tool-crosswalk.yml

## Other Prisma APIs (12)

- [Prisma Aggregation API](https://apis.io/apis/prisma/prisma-aggregation-api/)
- [Prisma API Keys API](https://apis.io/apis/prisma/prisma-api-keys-api/)
- [Prisma Batch API](https://apis.io/apis/prisma/prisma-batch-api/)
- [Prisma Cache API](https://apis.io/apis/prisma/prisma-cache-api/)
- [Prisma Connections API](https://apis.io/apis/prisma/prisma-connections-api/)
- [Prisma CRUD API](https://apis.io/apis/prisma/prisma-crud-api/)
- [Prisma Database Backups API](https://apis.io/apis/prisma/prisma-database-backups-api/)
- [Prisma Database Usage API](https://apis.io/apis/prisma/prisma-database-usage-api/)
- [Prisma Databases API](https://apis.io/apis/prisma/prisma-databases-api/)
- [Prisma Environments API](https://apis.io/apis/prisma/prisma-environments-api/)
- [Prisma Events API](https://apis.io/apis/prisma/prisma-events-api/)
- [Prisma Health API](https://apis.io/apis/prisma/prisma-health-api/)

## Tags

Experimental

---

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