# [Experimental]

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

## Operations

| Method | Path | Operation |
| --- | --- | --- |
| `GET` | `/v1/apps` | [List apps](../getv1apps.md) |
| `POST` | `/v1/apps` | [Create app](../postv1apps.md) |
| `DELETE` | `/v1/apps/{appId}` | [Delete app](../deletev1appsbyappid.md) |
| `GET` | `/v1/apps/{appId}` | [Get app](../getv1appsbyappid.md) |
| `PATCH` | `/v1/apps/{appId}` | [Update app](../patchv1appsbyappid.md) |
| `GET` | `/v1/apps/{appId}/deployments` | [List deployments](../getv1appsbyappiddeployments.md) |
| `POST` | `/v1/apps/{appId}/deployments` | [Create deployment](../postv1appsbyappiddeployments.md) |
| `GET` | `/v1/apps/{appId}/domains` | [List custom domains for an app](../getv1appsbyappiddomains.md) |
| `POST` | `/v1/apps/{appId}/domains` | [Create a custom domain](../postv1appsbyappiddomains.md) |
| `POST` | `/v1/apps/{appId}/promote` | [Promote deployment](../postv1appsbyappidpromote.md) |
| `POST` | `/v1/apps/{appId}/rollback` | [Roll an app back to an existing deployment](../postv1appsbyappidrollback.md) |
| `POST` | `/v1/auth/github-actions/token` | [Exchange a GitHub Actions OIDC token for a workspace service token](../postv1authgithub-actionstoken.md) |
| `DELETE` | `/v1/branches/{branchId}` | [Soft-delete a branch](../deletev1branchesbybranchid.md) |
| `GET` | `/v1/branches/{branchId}` | [Get a branch](../getv1branchesbybranchid.md) |
| `PATCH` | `/v1/branches/{branchId}` | [Update a branch](../patchv1branchesbybranchid.md) |
| `GET` | `/v1/builds` | [List builds](../getv1builds.md) |
| `POST` | `/v1/builds` | [Report a build](../postv1builds.md) |
| `GET` | `/v1/builds/{buildId}` | [Get a build](../getv1buildsbybuildid.md) |
| `PATCH` | `/v1/builds/{buildId}` | [Update a build](../patchv1buildsbybuildid.md) |
| `GET` | `/v1/builds/{buildId}/logs` | [Stream build logs](../getv1buildsbybuildidlogs.md) |
| `PUT` | `/v1/builds/{buildId}/resources/{resourceType}/{resourceId}` | [Report a resource a build acted on](../putv1buildsbybuildidresourcesbyresourcetypebyresourceid.md) |
| `DELETE` | `/v1/deployments/{deploymentId}` | [Delete deployment](../deletev1deploymentsbydeploymentid.md) |
| `GET` | `/v1/deployments/{deploymentId}` | [Get deployment](../getv1deploymentsbydeploymentid.md) |
| `GET` | `/v1/deployments/{deploymentId}/logs` | [Get deployment logs](../getv1deploymentsbydeploymentidlogs.md) |
| `POST` | `/v1/deployments/{deploymentId}/start` | [Start deployment](../postv1deploymentsbydeploymentidstart.md) |
| `POST` | `/v1/deployments/{deploymentId}/stop` | [Stop deployment](../postv1deploymentsbydeploymentidstop.md) |
| `DELETE` | `/v1/domains/{domainId}` | [Delete a custom domain](../deletev1domainsbydomainid.md) |
| `GET` | `/v1/domains/{domainId}` | [Get a custom domain](../getv1domainsbydomainid.md) |
| `POST` | `/v1/domains/{domainId}/retry` | [Retry custom domain provisioning](../postv1domainsbydomainidretry.md) |
| `GET` | `/v1/environment-variables` | [List environment variables](../getv1environment-variables.md) |
| `POST` | `/v1/environment-variables` | [Create an environment variable](../postv1environment-variables.md) |
| `DELETE` | `/v1/environment-variables/{envVarId}` | [Delete an environment variable](../deletev1environment-variablesbyenvvarid.md) |
| `GET` | `/v1/environment-variables/{envVarId}` | [Get an environment variable](../getv1environment-variablesbyenvvarid.md) |
| `PATCH` | `/v1/environment-variables/{envVarId}` | [Update an environment variable's value](../patchv1environment-variablesbyenvvarid.md) |
| `GET` | `/v1/projects/{projectId}/branches` | [List branches in a project](../getv1projectsbyprojectidbranches.md) |
| `POST` | `/v1/projects/{projectId}/branches` | [Create a branch](../postv1projectsbyprojectidbranches.md) |
| `DELETE` | `/v1/projects/{projectId}/branches/{branchId}/alchemy-state/lease` | [Release Alchemy deploy lease](../deletev1projectsbyprojectidbranchesbybranchidalchemy-statelease.md) |
| `PATCH` | `/v1/projects/{projectId}/branches/{branchId}/alchemy-state/lease` | [Heartbeat Alchemy deploy lease](../patchv1projectsbyprojectidbranchesbybranchidalchemy-statelease.md) |
| `POST` | `/v1/projects/{projectId}/branches/{branchId}/alchemy-state/lease` | [Acquire Alchemy deploy lease](../postv1projectsbyprojectidbranchesbybranchidalchemy-statelease.md) |
| `GET` | `/v1/projects/{projectId}/branches/{branchId}/alchemy-state/state/stacks` | [List Alchemy stacks](../getv1projectsbyprojectidbranchesbybranchidalchemy-statestatestacks.md) |
| `DELETE` | `/v1/projects/{projectId}/branches/{branchId}/alchemy-state/state/stacks/{stack}` | [Delete Alchemy stack state](../deletev1projectsbyprojectidbranchesbybranchidalchemy-statestatestacksbystack.md) |
| `GET` | `/v1/projects/{projectId}/branches/{branchId}/alchemy-state/state/stacks/{stack}/stages` | [List Alchemy stages](../getv1projectsbyprojectidbranchesbybranchidalchemy-statestatestacksbystackstages.md) |
| `GET` | `/v1/projects/{projectId}/branches/{branchId}/alchemy-state/state/stacks/{stack}/stages/{stage}/output` | [Get Alchemy stack output](../getv1projectsbyprojectidbranchesbybranchidalchemy-statestatestacksbystackstagesbystageoutput.md) |
| `PUT` | `/v1/projects/{projectId}/branches/{branchId}/alchemy-state/state/stacks/{stack}/stages/{stage}/output` | [Set Alchemy stack output](../putv1projectsbyprojectidbranchesbybranchidalchemy-statestatestacksbystackstagesbystageoutput.md) |
| `GET` | `/v1/projects/{projectId}/branches/{branchId}/alchemy-state/state/stacks/{stack}/stages/{stage}/replaced-resources` | [List replaced Alchemy resources](../getv1projectsbyprojectidbranchesbybranchidalchemy-statestatestacksbystackstagesbystagereplaced-resources.md) |
| `GET` | `/v1/projects/{projectId}/branches/{branchId}/alchemy-state/state/stacks/{stack}/stages/{stage}/resources` | [List Alchemy resources](../getv1projectsbyprojectidbranchesbybranchidalchemy-statestatestacksbystackstagesbystageresources.md) |
| `DELETE` | `/v1/projects/{projectId}/branches/{branchId}/alchemy-state/state/stacks/{stack}/stages/{stage}/resources/{fqn}` | [Delete Alchemy resource state](../deletev1projectsbyprojectidbranchesbybranchidalchemy-statestatestacksbystackstagesbystageresourcesbyfqn.md) |
| `GET` | `/v1/projects/{projectId}/branches/{branchId}/alchemy-state/state/stacks/{stack}/stages/{stage}/resources/{fqn}` | [Get Alchemy resource state](../getv1projectsbyprojectidbranchesbybranchidalchemy-statestatestacksbystackstagesbystageresourcesbyfqn.md) |
| `PUT` | `/v1/projects/{projectId}/branches/{branchId}/alchemy-state/state/stacks/{stack}/stages/{stage}/resources/{fqn}` | [Set Alchemy resource state](../putv1projectsbyprojectidbranchesbybranchidalchemy-statestatestacksbystackstagesbystageresourcesbyfqn.md) |
| `GET` | `/v1/projects/{projectId}/branches/{branchId}/alchemy-state/version` | [Alchemy state store version](../getv1projectsbyprojectidbranchesbybranchidalchemy-stateversion.md) |
| `GET` | `/v1/projects/{projectId}/branches/{branchId}/application-topology` | [Get branch topology](../getv1projectsbyprojectidbranchesbybranchidapplication-topology.md) |
| `PUT` | `/v1/projects/{projectId}/branches/{branchId}/application-topology` | [Replace branch topology](../putv1projectsbyprojectidbranchesbybranchidapplication-topology.md) |
| `GET` | `/v1/scm-installations` | [List SCM installations for a workspace](../getv1scm-installations.md) |
| `POST` | `/v1/scm-installations/install-intents` | [Create an SCM App installation intent](../postv1scm-installationsinstall-intents.md) |
| `GET` | `/v1/scm-installations/{installationId}/repositories` | [List repositories accessible to an SCM installation](../getv1scm-installationsbyinstallationidrepositories.md) |
| `GET` | `/v1/services` | [List services](../getv1services.md) |
| `POST` | `/v1/services` | [Create service](../postv1services.md) |
| `DELETE` | `/v1/services/{serviceId}` | [Delete service](../deletev1servicesbyserviceid.md) |
| `GET` | `/v1/services/{serviceId}` | [Get service](../getv1servicesbyserviceid.md) |
| `PATCH` | `/v1/services/{serviceId}` | [Update service](../patchv1servicesbyserviceid.md) |
| `GET` | `/v1/services/{serviceId}/deployments` | [List deployments](../getv1servicesbyserviceiddeployments.md) |
| `POST` | `/v1/services/{serviceId}/deployments` | [Create deployment](../postv1servicesbyserviceiddeployments.md) |
| `GET` | `/v1/services/{serviceId}/domains` | [List custom domains for a service](../getv1servicesbyserviceiddomains.md) |
| `POST` | `/v1/services/{serviceId}/domains` | [Create a custom domain](../postv1servicesbyserviceiddomains.md) |
| `POST` | `/v1/services/{serviceId}/promote` | [Promote deployment](../postv1servicesbyserviceidpromote.md) |
| `POST` | `/v1/services/{serviceId}/rollback` | [Roll a service back to an existing deployment](../postv1servicesbyserviceidrollback.md) |
| `GET` | `/v1/source-repositories` | [List source repositories](../getv1source-repositories.md) |
| `POST` | `/v1/source-repositories` | [Link a source repository to a project](../postv1source-repositories.md) |
| `DELETE` | `/v1/source-repositories/{id}` | [Disconnect a source repository](../deletev1source-repositoriesbyid.md) |
| `GET` | `/v1/source-repositories/{id}` | [Get a source repository](../getv1source-repositoriesbyid.md) |
| `POST` | `/v1/workspaces` | [Create a workspace](../postv1workspaces.md) |

## Related pages

- [Acquire Alchemy deploy lease](../postv1projectsbyprojectidbranchesbybranchidalchemy-statelease.md)
- [Agents](./agents.md)
- [Alchemy state store version](../getv1projectsbyprojectidbranchesbybranchidalchemy-stateversion.md)
- [Buckets](./buckets.md)
- [Connections](./connections.md)
- [Create a branch](../postv1projectsbyprojectidbranches.md)
- [Create a custom domain](../postv1appsbyappiddomains.md)
- [Create a custom domain](../postv1servicesbyserviceiddomains.md)
- [Create a workspace](../postv1workspaces.md)
- [Create an environment variable](../postv1environment-variables.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.