# Prisma integration

> Prisma Management API: manage Prisma Postgres projects, databases, connection strings, backups, usage, buckets, regions and workspace service tokens.

- Authentication: apiKey

## Tools (103)

- **Acquire Alchemy deploy lease**: Acquires the deploy lease for a (branch, stack, stage)
- **Alchemy state store version**: Unauthenticated contract-version probe served verbatim from the pinned alchemy HttpStateApi contract
- **Create a branch**: Creates a Branch under the specified Project
- **Create a custom domain**: Registers a custom hostname for the service
- **Create an environment variable**: Creates a new environment variable in a project's `production` or `preview` environment, or a preview branch override when `branchId` is supplied
- **Create an SCM App installation intent**: Creates an installation intent for the given workspace
- **Create bucket**: Creates a new object-store bucket in the specified project.
- **Create bucket key**: Creates a new access key for the given bucket
- **Create connection**: Creates a new connection for the specified database.
- **Create database**: Creates a new database in the specified project
- **Create database connection string**: Creates a new connection string for the given database.
- **Create database (projects/{projectId}/databases)**: Creates a new database for the given project.
- **Create deployment**: Creates a new deployment under the specified service
- **Create project with a postgres database**: Creates a new project with a postgres database.
- **Create service**: Creates a new service under the specified project
- **Create service token**: Creates a new service token for the given workspace
- **Delete a custom domain**: Removes a custom domain binding
- **Delete Alchemy resource state**: Deletes the resource state row
- **Delete Alchemy stack state**: Deletes every resource-state and output row of the stack, or only the given stage's rows when the stage query parameter is set
- **Delete an environment variable**: Removes an environment variable
- **Delete bucket**: Permanently deletes the bucket with the given ID, all objects stored in it, and all its access keys
- **Delete bucket key**: Revokes and deletes the bucket key with the given ID.
- **Delete connection**: Deletes the connection with the given ID.
- **Delete database**: Deletes the database with the given ID.
- **Delete deployment**: Permanently deletes the deployment, its metadata, and any associated VM
- **Delete integration**: Revokes the integration tokens by integration ID.
- **Delete project**: Deletes the project with the given ID.
- **Delete service**: Deletes a service
- **Delete service token**: Revokes the service token with the given ID by deleting it.
- **Disconnect a source repository**: Disconnects the source repository link
- **Get a branch**: Returns a single Branch by ID
- **Get a build**: Returns one build with the resources it reported acting on
- **Get a custom domain**: Returns details for a custom domain by id
- **Get Alchemy resource state**: Returns the stored resource state, or a JSON null body when absent (the stock client maps null to undefined)
- **Get Alchemy stack output**: Returns the stored stack output for the stage, or a JSON null body when absent (the stock client maps null to undefined)
- **Get all regions**: Returns all available regions across products
- **Get an environment variable**: Returns a single environment variable's metadata
- **Get a source repository**: Returns a single source repository link by ID
- **Get branch topology**: Returns the stored topology graph for the branch — the same shape Composer submitted
- **Get bucket**: Returns the bucket with the given ID.
- **Get connection**: Returns the connection with the given ID.
- **Get current authenticated principal**: Returns the user, workspace, and credential represented by the current token.
- **Get database**: Returns the database with the given ID.
- **Get database usage metrics**: Returns usage metrics for the specified database.
- **Get deployment**: Returns a deployment by ID, including its current status derived from the underlying VM state
- **Get deployment logs**: Returns log output for the specified deployment
- **Get integration by ID**: Returns a single integration by its ID.
- **Get list of backups**: Returns backups for the specified database.
- **Get list of database connections**: Returns all connections for the given database.
- **Get list of databases**: Returns databases for the given project.
- **Get list of integrations**: Returns integrations filtered by workspace ID.
- **Get list of integrations (workspaces/{workspaceId}/integrations)**: Returns integrations for the given workspace.
- **Get list of projects**: Returns the list of projects the token has access to.
- **Get list of workspaces**: Returns the list of workspaces the current token can access.
- **Get Prisma Accelerate regions**: Returns all available regions for Prisma Accelerate.
- **Get Prisma Postgres regions**: Returns all available regions for Prisma Postgres.
- **Get project**: Returns the project with the given ID.
- **Get service**: Returns a service by ID, including its region and active promoted deployment reference
- **Get workspace**: Returns the workspace with the given ID.
- **Get workspace subscription**: Returns subscription information for the workspace with the given ID.
- **Heartbeat Alchemy deploy lease**: Extends the unexpired deploy lease addressed by the Alchemy-State-Lease-Id header from now
- **Link a source repository to a project**: Links a GitHub repository to a Prisma project via an existing SCM installation
- **List Alchemy resources**: Lists the resource FQNs stored for the stage, ordered by FQN
- **List Alchemy stacks**: Lists the distinct stack names with state or output rows on the branch
- **List Alchemy stages**: Lists the distinct stage names with state or output rows for the stack
- **List branches in a project**: Returns the live Branches of a Project
- **List bucket keys**: Returns all access keys for the given bucket.
- **List buckets**: Returns all object-store buckets the token has access to
- **List builds**: Lists the builds of the caller's workspace, newest first, filtered by project, branch, or state
- **List connections**: Returns all connections the actor has access to, with optional database filter.
- **List custom domains for a service**: Returns all custom domains attached to any deployment of the service
- **List databases**: Returns all databases the token has access to
- **List deployments**: Returns all deployments belonging to a service, ordered by creation time (newest first)
- **List environment variables**: Returns a paginated list of environment variables
- **List replaced Alchemy resources**: Returns the decrypted resource states of the stage whose status is "replaced"
- **List repositories accessible to an SCM installation**: Lists repositories accessible to the given SCM installation
- **List SCM installations for a workspace**: Lists active SCM installations connected to the given workspace
- **List services**: Returns all services the token has access to, ordered by creation time (oldest first)
- **List service tokens**: Returns the service tokens for the given workspace, newest first.
- **List source repositories**: Returns source repositories linked to a project
- **Promote deployment**: Promotes a deployment to be the active deployment behind the service's stable endpoint
- **Release Alchemy deploy lease**: Releases the deploy lease addressed by the Alchemy-State-Lease-Id header on clean deploy exit
- **Replace branch topology**: Atomically replaces the entire topology for a branch
- **Report a build**: Records a build any deploy tool is running — a CI workflow, a deploy script, or Composer from a laptop
- **Report a resource a build acted on**: Records that the build created, acted on, or deleted a platform resource — the provenance a deploy run leaves behind
- **Restore database (destructive)**: ⚠️ **Destructive operation** — this immediately and irreversibly overwrites all data in the target database with the contents of the specified backup
- **Retry custom domain provisioning**: Retries DNS verification and certificate issuance for a failed or pending domain
- **Revoke integration tokens**: Revokes the integration tokens with the given client ID.
- **Roll a service back to an existing deployment**: Makes any eligible existing deployment live behind the service's stable endpoint (rollback or roll-forward)
- **Rotate connection credentials**: Generates new credentials for the connection with the given ID
- **Set Alchemy resource state**: Stores the resource state encrypted at rest and echoes the stored value
- **Set Alchemy stack output**: Overwrites the stack output for the stage, encrypted at rest, and echoes the stored value
- **Soft-delete a branch**: Soft-deletes a Branch (sets deletedAt)
- **Start deployment**: Requests VM creation and startup for the deployment
- **Stop deployment**: Requests VM shutdown for the deployment
- **Transfer project**: Transfer the project with the given ID to the new owner's workspace
- **Update a branch**: Promotes a Branch to be the Project's default
- **Update a build**: Records progress on a build
- **Update an environment variable's value**: Replaces the value of an existing environment variable
- **Update bucket**: Updates the display name, logical id, or branch of the bucket with the given ID
- **Update database**: Updates the database with the given ID
- **Update project**: Updates the project with the given ID.
- **Update service**: Updates the display name, logical id, or branch of a service

Connect Prisma in General Input: https://www.generalinput.com/apps/prisma