> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Prisma

> Prisma Data Platform provides database tools including Accelerate (global database cache), Optimize (AI-driven query analysis), and Prisma Postgres (managed PostgreSQL). Manage workspaces, projects, environments, and API keys programmatically.

![Prisma logo](https://mintcdn.com/composio-preview/HvfZXDijhFOaKyF5/images/toolkits/prisma.svg?fit=max\&auto=format\&n=HvfZXDijhFOaKyF5\&q=85\&s=01037ff5b7952b64b560c481f2b4347a)

* **Category:** databases
* **Auth:** OAUTH2, API\_KEY
* **Composio-managed OAuth available?** Yes
* **Tools:** 22
* **Triggers:** 0
* **Slug:** `PRISMA`
* **Version:** 20261101\_00

## Tools

> [accordion] Create Bucket
>
> **Slug:** `PRISMA_CREATE_BUCKET`
>
> Create an object-store bucket in an existing Prisma project. Optionally set a display name, associate a branch by ID or Git name, and declare a logical identity unique within that branch. Returns bucket metadata.
>
> #### Input Parameters
>
> **name** `string`
>
> Display name for the bucket. Generated if omitted.
>
> **branchId** `string`
>
> Branch to associate the bucket with. Mutually exclusive with branchGitName.
>
> **logicalId** `string`
>
> Declared resource identity, unique within its branch. Set by the tool declaring the resource.
>
> **projectId** `string` *required*
>
> ID of the project to create the bucket in.
>
> **branchGitName** `string`
>
> Git name of the branch to associate the bucket with. Mutually exclusive with branchId.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Bucket Key
>
> **Slug:** `PRISMA_CREATE_BUCKET_KEY`
>
> Create an access key for an existing Prisma object-store bucket. Choose read-only or read/write access and optionally a display name. Returns connection details and a secretAccessKey that is returned exactly once and never stored by Prisma; copy it immediately.
>
> #### Input Parameters
>
> **name** `string`
>
> Display name for the key. Generated if omitted.
>
> **role** `string ("read" | "read_write")` *required*
>
> Access role for the key: 'read' or 'read\_write'.
>
> **bucketId** `string` *required*
>
> ID of the bucket to create an access key for.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Database Connection
>
> **Slug:** `PRISMA_CREATE_CONNECTION`
>
> Create new API key connection for database access. Creates connection string with embedded credentials for application database access. Returns complete connection details ready for immediate use.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Human-readable name for the new connection/API key. This will be displayed in UIs and used for identification. Choose descriptive names like 'Production API Key', 'Analytics Access', 'Dev Environment', etc.
>
> **databaseId** `string` *required*
>
> Unique database identifier to create connection for (format: 'db\_xxxxx'). Must be a database the authenticated user has write access to. The new connection will provide API key access to this database.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Project Database
>
> **Slug:** `PRISMA_CREATE_DATABASE`
>
> Create new postgres database in an existing Prisma project. Creates database in specified region with connection strings and API keys. Returns complete database details ready for immediate use.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Human-readable name for the new database. This will be displayed in UIs and used for identification. Choose descriptive names like 'Production DB', 'Analytics', etc.
>
> **region** `string` *required*
>
> AWS region where the database will be deployed. Valid values: 'us-east-1', 'us-west-1', 'eu-central-1', 'eu-west-3', 'ap-southeast-1', 'ap-northeast-1'. Choose region closest to your users for optimal performance. Use LIST\_POSTGRES\_REGIONS to get current available regions.
>
> **isDefault** `boolean`
>
> Whether this database should be the default for the project. Default false. Only one database can be default per project. Setting to true will make other databases non-default.
>
> **projectId** `string` *required*
>
> Unique project identifier to create database in (format: 'prj\_xxxxx'). Must be a project the authenticated user has write access to. The new database will belong to this project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Managed Connection
>
> **Slug:** `PRISMA_CREATE_MANAGED_CONNECTION`
>
> Create a managed connection for an existing Prisma database. Returns connection metadata and endpoint connection strings with credentials on creation. Use the returned endpoints for direct, pooled, or Accelerate access.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Display name for the new connection (3–65 characters).
>
> **databaseId** `string` *required*
>
> ID of the database to create the connection for.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Managed Database
>
> **Slug:** `PRISMA_CREATE_MANAGED_DATABASE`
>
> Create a managed database in a Prisma project, optionally cloning or restoring it. Omit source for an empty database. Select a region, default status, branch and declared logical identity as needed. Returns database and connection metadata.
>
> #### Input Parameters
>
> **name** `string`
>
> Database display name.
>
> **region** `string ("us-east-1" | "us-west-1" | "eu-west-3" | "eu-central-1" | "ap-northeast-1" | "ap-southeast-1" | "inherit")`
>
> Defaults to us-east-1 when omitted. Use "inherit" for the project default region, falling back to its default database region.
>
> **source** `string`
>
> Creation source. Omit to create an empty database.
>
> **branchId** `string`
>
> Branch ID; mutually exclusive with branchGitName. Omit for the project's default branch; null is rejected.
>
> **isDefault** `boolean`
>
> Whether this is the default database; defaults to false.
>
> **logicalId** `string`
>
> Declared identity, unique within its branch. Cannot be combined with branchGitName; use branchId instead.
>
> **projectId** `string` *required*
>
> ID of the project to create the database in.
>
> **branchGitName** `string`
>
> Git branch name; creates the branch if absent. Mutually exclusive with branchId and logicalId. Omit for the default branch; null is rejected.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Prisma Project
>
> **Slug:** `PRISMA_CREATE_PROJECT`
>
> Create new Prisma project with managed postgres database. Creates project in authenticated user's workspace with postgres database in specified region. Returns complete project details including connection strings and API keys.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Human-readable name for the new project. This will be displayed in UIs and used for identification. Choose descriptive names like 'Production API', 'Dev Environment', etc.
>
> **region** `string` *required*
>
> AWS region where the postgres database will be deployed. Available regions: 'us-east-1', 'us-west-1', 'eu-central-1', 'eu-west-3', 'ap-southeast-1', 'ap-northeast-1'. Choose region closest to your users for optimal performance.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Service Token
>
> **Slug:** `PRISMA_CREATE_SERVICE_TOKEN`
>
> Create a service token in a Prisma workspace, optionally limited to one project. Returns the secret value exactly once; copy it immediately. Expiry defaults to 90 days when omitted; explicitly pass null to create a token without expiry.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Display name for the service token.
>
> **expiresAt** `string`
>
> Expiry timestamp in the future. Omit for the provider's 90-day default; pass null for no expiry.
>
> **projectId** `string`
>
> Restrict access to this project. Omit or pass null for Full Workspace access.
>
> **workspaceId** `string` *required*
>
> ID of the workspace in which to create the service token.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Bucket
>
> **Slug:** `PRISMA_DELETE_BUCKET`
>
> Permanently delete a bucket, all objects stored in it, and all its access keys. This action cannot be undone. Returns a tool-local success acknowledgment after the provider accepts the deletion with no response body.
>
> #### Input Parameters
>
> **bucketId** `string` *required*
>
> ID of the bucket to permanently delete, including all objects and access keys.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Bucket Key
>
> **Slug:** `PRISMA_DELETE_BUCKET_KEY`
>
> Revoke and delete a bucket access key by its bucket and key IDs. Returns a tool-local success acknowledgment after the provider accepts the deletion with no response body.
>
> #### Input Parameters
>
> **keyId** `string` *required*
>
> ID of the bucket access key to revoke and delete.
>
> **bucketId** `string` *required*
>
> ID of the bucket that owns the access key.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Database Connection
>
> **Slug:** `PRISMA_DELETE_CONNECTION`
>
> Permanently delete database connection and revoke API key access. WARNING: This immediately revokes database access for any applications using this connection string. Ensure no critical systems depend on this connection.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique connection identifier to delete (format: 'con\_xxxxx'). WARNING: This permanently revokes API key access to the database. Any applications using this connection string will lose access immediately. This action cannot be undone - ensure no critical systems depend on this connection.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Prisma Database
>
> **Slug:** `PRISMA_DELETE_DATABASE`
>
> Permanently delete Prisma database and all stored data. WARNING: This action cannot be undone. All data in the database will be permanently destroyed. Default databases typically cannot be deleted.
>
> #### Input Parameters
>
> **databaseId** `string` *required*
>
> Unique database identifier to delete (format: 'db\_xxxxx'). WARNING: This permanently deletes the database and all stored data. Default databases typically cannot be deleted. This action cannot be undone. Ensure all important data is backed up before deletion.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Integration
>
> **Slug:** `PRISMA_DELETE_INTEGRATION`
>
> Revoke the integration tokens by integration ID. Returns a tool-local success acknowledgment after the provider accepts the revocation with no response body.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> ID of the integration whose tokens should be revoked.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Prisma Project
>
> **Slug:** `PRISMA_DELETE_PROJECT`
>
> Permanently delete Prisma project and all associated resources. WARNING: This action cannot be undone. All databases, environments, and project data will be permanently destroyed. Use with extreme caution in production environments.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique project identifier to delete (format: 'proj\_xxxxx'). WARNING: This permanently deletes the project and all associated data including databases, environments, and configurations. This action cannot be undone. Ensure all important data is backed up before deletion.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Service Token
>
> **Slug:** `PRISMA_DELETE_SERVICE_TOKEN`
>
> Revoke a workspace service token by deleting it. Returns a tool-local success acknowledgment after the provider accepts the deletion with no response body.
>
> #### Input Parameters
>
> **workspaceId** `string` *required*
>
> ID of the workspace that owns the service token.
>
> **serviceTokenId** `string` *required*
>
> ID of the service token to revoke and delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Execute SQL Command
>
> **Slug:** `PRISMA_EXECUTE_SQL_COMMAND`
>
> Execute SQL commands that modify database data or structure. Runs INSERT, UPDATE, DELETE, CREATE TABLE, and other data modification commands safely through PostgreSQL driver with parameterized query support.
>
> #### Input Parameters
>
> **command** `string` *required*
>
> SQL command to execute against the database (INSERT, UPDATE, DELETE, CREATE TABLE, etc.). Examples: 'INSERT INTO users (name, email) VALUES (\$1, \$2)', 'UPDATE users SET active = \$1 WHERE id = \$2', 'DELETE FROM sessions WHERE expires\_at \< NOW()', 'CREATE TABLE logs (id SERIAL PRIMARY KEY, message TEXT, created\_at TIMESTAMP DEFAULT NOW())'
>
> **parameters** `array`
>
> Optional array of parameters for parameterized commands using \$1, \$2, etc. placeholders. Example: command='INSERT INTO users (name, email) VALUES (\$1, \$2)', parameters=\['John Doe', '[john@example.com](mailto:john@example.com)']. Parameters are automatically escaped to prevent SQL injection.
>
> **connectionString** `string` *required*
>
> PostgreSQL connection string for direct database access. Use the standard format: 'postgresql://USER:PASSWORD\@HOST:PORT/DATABASE?sslmode=require'. Get credentials from create\_connection or create\_database response fields: use 'user' as USER, 'pass' as PASSWORD, and 'host' as HOST:PORT. Example: 'postgresql://user:[pass@db.prisma.io](mailto:pass@db.prisma.io):5432/postgres?sslmode=require'. Note: Do NOT use Prisma Accelerate URLs (prisma+postgres\://accelerate.prisma-data.net/...) - those are for Prisma Client SDK only. Use the direct connection credentials instead.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Execute SQL Query
>
> **Slug:** `PRISMA_EXECUTE_SQL_QUERY`
>
> Execute SQL queries through a direct SSL PostgreSQL connection and return rows, row count, and execution time. SQL is not restricted to read-only statements; commands may modify data even if fetching results fails.
>
> #### Input Parameters
>
> **host** `string` *required*
>
> Database host with port (format: 'db.prisma.io:5432'). Obtain this from create\_connection action response field 'host'. This is the direct PostgreSQL endpoint for your Prisma Postgres database.
>
> **user** `string` *required*
>
> Database username (tenant ID from Prisma). Obtain this from create\_connection action response field 'user'. This is a unique identifier for your database tenant.
>
> **query** `string` *required*
>
> SQL SELECT query to execute against the database. Use standard PostgreSQL syntax. Common examples: 'SELECT \* FROM users LIMIT 10', 'SELECT name, email FROM customers WHERE active = true', 'SELECT table\_name FROM information\_schema.tables WHERE table\_schema = 'public''. Avoid INSERT/UPDATE/DELETE - use execute\_sql\_command for those operations.
>
> **password** `string` *required*
>
> Database password (secret key from Prisma). Obtain this from create\_connection action response field 'pass'. Format is typically 'sk\_xxxxx'. Keep this secure.
>
> **parameters** `array`
>
> Optional array of parameters for parameterized queries using %s placeholders. Example: query='SELECT \* FROM users WHERE id = %s AND active = %s', parameters=\[123, true]. Parameters are automatically escaped to prevent SQL injection. Use %s for each parameter in order they appear in the query.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Bucket
>
> **Slug:** `PRISMA_GET_BUCKET`
>
> Get an object-store bucket by ID, including its project and branch metadata.
>
> #### Input Parameters
>
> **bucketId** `string` *required*
>
> ID of the bucket to retrieve, with or without the bkt\_ prefix.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Connection
>
> **Slug:** `PRISMA_GET_CONNECTION`
>
> Get a connection by ID, including its endpoints and database metadata.
>
> #### Input Parameters
>
> **connectionId** `string` *required*
>
> ID of the connection to retrieve, with or without the con\_ prefix.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Current Principal
>
> **Slug:** `PRISMA_GET_CURRENT_PRINCIPAL`
>
> Get the user, workspace, and credential represented by the current token.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Prisma Database
>
> **Slug:** `PRISMA_GET_DATABASE`
>
> Retrieve specific Prisma database by ID. Returns database details including status, project context, and regional deployment. Use for database monitoring, validation, and administrative operations.
>
> #### Input Parameters
>
> **databaseId** `string` *required*
>
> Unique database identifier to retrieve (format: 'db\_xxxxx'). This ID is obtained from database listing or creation operations. Must be a database the authenticated user has access to.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Database Usage Metrics
>
> **Slug:** `PRISMA_GET_DATABASE_USAGE`
>
> Retrieve usage metrics for a specific Prisma database. Returns metrics including storage usage and operation counts (reads/writes) for the specified time period. Use for monitoring resource consumption, cost analysis, and capacity planning.
>
> #### Input Parameters
>
> **endDate** `string`
>
> End date for metrics query in ISO 8601 format (e.g., '2025-07-31T23:59:59Z'). Defaults to current date if not provided. Will be set to end of day if a future date is provided.
>
> **startDate** `string`
>
> Start date for metrics query in ISO 8601 format (e.g., '2025-07-01T00:00:00Z'). Defaults to start of current month if not provided. Use to specify custom date ranges for usage analysis.
>
> **databaseId** `string` *required*
>
> Unique database identifier to retrieve usage metrics for (format: 'db\_xxxxx'). Must be a database the authenticated user has access to. This ID is obtained from database listing or creation operations.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Integration
>
> **Slug:** `PRISMA_GET_INTEGRATION`
>
> Get an integration by ID, including its scopes, client, and creating user.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> ID of the integration to retrieve, with or without the itgr\_ prefix.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Prisma Project
>
> **Slug:** `PRISMA_GET_PROJECT`
>
> Retrieve specific Prisma project by ID. Returns project details including name, creation timestamp, and workspace information. Use for project detail views, validation, and administrative operations.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique project identifier to retrieve (format: 'proj\_xxxxx'). This ID is obtained from project listing or creation operations. Must be a project the authenticated user has access to.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Workspace
>
> **Slug:** `PRISMA_GET_WORKSPACE`
>
> Get a workspace by ID, including its name, resource URL, and creation time.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> ID of the workspace to retrieve, with or without the wksp\_ prefix.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Workspace Subscription
>
> **Slug:** `PRISMA_GET_WORKSPACE_SUBSCRIPTION`
>
> Get a workspace's subscription plan, usage-blocked status, and upgrade URL.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> ID of the workspace, with or without the wksp\_ prefix.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Inspect Database Schema
>
> **Slug:** `PRISMA_INSPECT_DATABASE_SCHEMA`
>
> Inspect tables and columns in the public database schema, optionally for a named table. Returns data types, nullability, defaults, primary and foreign key information, and row counts.
>
> #### Input Parameters
>
> **host** `string` *required*
>
> Database host with port (format: 'db.prisma.io:5432'). Obtain this from create\_connection action response field 'host'. This is the direct PostgreSQL endpoint for your Prisma Postgres database.
>
> **user** `string` *required*
>
> Database username (tenant ID from Prisma). Obtain this from create\_connection action response field 'user'. This is a unique identifier for your database tenant.
>
> **password** `string` *required*
>
> Database password (secret key from Prisma). Obtain this from create\_connection action response field 'pass'. Format is typically 'sk\_xxxxx'. Keep this secure.
>
> **tableName** `string`
>
> Optional specific table name to inspect. If provided, returns detailed column information for that table only. If omitted, returns overview of all tables in the database. Use for focused schema analysis of specific tables.
>
> **includeIndexes** `boolean`
>
> Whether to include index information in the schema results. When true, shows primary keys, foreign keys, and other indexes. Useful for understanding table relationships and query optimization.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Prisma Accelerate Regions
>
> **Slug:** `PRISMA_LIST_ACCELERATE_REGIONS`
>
> Retrieve all available regions for Prisma Accelerate. Returns regions where Accelerate global database cache can be deployed. Use for cache region selection to minimize latency for your users.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List All Connections
>
> **Slug:** `PRISMA_LIST_ALL_CONNECTIONS`
>
> List all accessible connections, optionally filtered by database. Returns one page with endpoint and database metadata. Pass pagination.nextCursor as cursor to retrieve the next page, retaining the database filter if used.
>
> #### Input Parameters
>
> **limit** `number`
>
> Maximum connections per page; defaults to 100.
>
> **cursor** `string`
>
> Pagination cursor from the previous response's nextCursor.
>
> **databaseId** `string`
>
> Filter connections by database ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List All Databases
>
> **Slug:** `PRISMA_LIST_ALL_DATABASES`
>
> List databases across all projects accessible to the authenticated token. Optionally filter by project, declared identity, branch ID or Git branch name. Pass pagination.nextCursor as cursor with the same filters to fetch another page.
>
> #### Input Parameters
>
> **limit** `number`
>
> Page size; defaults to 100.
>
> **cursor** `string`
>
> Pagination cursor from the previous response's nextCursor.
>
> **branchId** `string`
>
> Filter by branch ID, or 'unassigned' for databases without a branch.
>
> **logicalId** `string`
>
> Declared resource identity, unique within its branch.
>
> **projectId** `string`
>
> Filter databases by project ID.
>
> **branchGitName** `string`
>
> Filter by the branch's Git name.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Database Backups
>
> **Slug:** `PRISMA_LIST_BACKUPS`
>
> Retrieve list of available backups for a specific database. Returns backup details including status, size, type, and restoration readiness. Use for backup monitoring, restoration planning, and compliance auditing.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of backups to return in a single request. Defaults to 25 if not specified. Typical range is 1-100. Use smaller values (10-25) for UI pagination, larger values (50-100) for processing.
>
> **databaseId** `string` *required*
>
> Unique database identifier to list backups for (format: 'db\_xxxxx'). Must be a database the authenticated user has access to. All available backups for this database will be returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Bucket Keys
>
> **Slug:** `PRISMA_LIST_BUCKET_KEYS`
>
> List access-key metadata for a bucket, without returning secret access keys. Returns one page. Pass pagination.nextCursor as cursor with the same bucketId to retrieve the next page.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum keys per page, from 1 to 100.
>
> **cursor** `string`
>
> Pagination cursor from the previous response's nextCursor.
>
> **bucketId** `string` *required*
>
> Identifier of the bucket whose access keys to list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Buckets
>
> **Slug:** `PRISMA_LIST_BUCKETS`
>
> List accessible object-store buckets with optional project and branch filters. Returns one page of bucket metadata. Pass pagination.nextCursor as cursor to retrieve the next page, retaining any filters used for the first page.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum buckets per page, from 1 to 100.
>
> **cursor** `string`
>
> Pagination cursor from the previous response's nextCursor.
>
> **branchId** `string`
>
> Filter by branch ID, or use 'unassigned' for buckets without a branch.
>
> **logicalId** `string`
>
> Filter by the resource's declared identity, unique within its branch.
>
> **projectId** `string`
>
> Filter buckets by project ID.
>
> **branchGitName** `string`
>
> Filter by the branch's Git name.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Database Connections
>
> **Slug:** `PRISMA_LIST_CONNECTIONS`
>
> Retrieve paginated list of connections for a specific database. Returns connection details including names, creation dates, and database context. Use for API key management, security audits, and access control.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of connections to return in a single request. Defaults to 100 if not specified. Valid range is typically 1-500. Use smaller values (10-50) for faster responses when you only need a few connections, or larger values (100-500) when bulk processing.
>
> **cursor** `string`
>
> Pagination cursor for retrieving the next page of results. Use the 'nextCursor' value from a previous response to get subsequent pages. Leave as None/null for the first page. Enables efficient pagination through large numbers of connections without missing or duplicating entries.
>
> **databaseId** `string` *required*
>
> Unique database identifier to list connections for (format: 'db\_xxxxx'). Must be a database the authenticated user has access to. All connection strings and API keys for this database will be returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Project Databases
>
> **Slug:** `PRISMA_LIST_DATABASES`
>
> Retrieve paginated list of databases for a specific Prisma project. Returns database details including status, region, and project context. Use for database discovery, monitoring, and project administration.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of databases to return in a single request. Defaults to 100 if not specified. Valid range is typically 1-500. Use smaller values (10-50) for faster responses when you only need a few databases, or larger values (100-500) when bulk processing.
>
> **cursor** `string`
>
> Pagination cursor for retrieving the next page of results. Use the 'nextCursor' value from a previous response to get subsequent pages. Leave as None/null for the first page. Enables efficient pagination through large numbers of databases without missing or duplicating entries.
>
> **projectId** `string` *required*
>
> Unique project identifier to list databases for (format: 'prj\_xxxxx'). Must be a project the authenticated user has access to. All databases belonging to this project will be returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Integrations
>
> **Slug:** `PRISMA_LIST_INTEGRATIONS`
>
> List integrations for a workspace, including clients, creators, and scopes. Returns one page. Pass pagination.nextCursor as cursor to retrieve the next page, retaining the same workspaceId.
>
> #### Input Parameters
>
> **limit** `number`
>
> Maximum integrations per page; defaults to 100.
>
> **cursor** `string`
>
> Pagination cursor from the previous response's nextCursor.
>
> **workspaceId** `string` *required*
>
> Workspace ID whose integrations to list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Prisma Postgres Regions
>
> **Slug:** `PRISMA_LIST_POSTGRES_REGIONS`
>
> Retrieve all available regions for Prisma Postgres. Returns regions where Prisma Postgres databases can be deployed with current availability status. Use for region selection during database creation and capacity planning.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Prisma Projects
>
> **Slug:** `PRISMA_LIST_PROJECTS`
>
> Retrieve paginated list of Prisma projects accessible to authenticated user. Returns project IDs, names, workspace info, and timestamps with cursor-based pagination. Use for project discovery, UI selection flows, and administrative operations.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of projects to return in a single request. Defaults to 100 if not specified. Valid range is typically 1-500. Use smaller values (10-50) for faster responses when you only need a few projects, or larger values (100-500) when bulk processing. The API may return fewer results than requested if fewer projects exist.
>
> **cursor** `string`
>
> Pagination cursor for retrieving the next page of results. Use the 'nextCursor' value from a previous response to get subsequent pages. Leave as None/null for the first page. This enables efficient pagination through large numbers of projects without missing or duplicating entries.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Regions
>
> **Slug:** `PRISMA_LIST_REGIONS`
>
> List all available regions across products, optionally filtered by product. Returns region identifiers, names, products, and availability status when provided.
>
> #### Input Parameters
>
> **product** `string ("postgres" | "accelerate")`
>
> Filter regions by product; omit to list all products.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Service Tokens
>
> **Slug:** `PRISMA_LIST_SERVICE_TOKENS`
>
> List workspace service-token metadata, newest first, without secret values. Returns one page. Pass pagination.nextCursor as cursor with the same workspaceId to retrieve the next page. The list is empty when the workspace does not exist or the caller is not a member of it.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum tokens per page, from 1 to 100.
>
> **cursor** `string`
>
> Pagination cursor from the previous response's nextCursor.
>
> **workspaceId** `string` *required*
>
> Identifier of the workspace whose service tokens to list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Workspace Integrations
>
> **Slug:** `PRISMA_LIST_WORKSPACE_INTEGRATIONS`
>
> Retrieve paginated list of integrations for a specific Prisma workspace. Returns integration details including OAuth client info, granted scopes, and creator. Use for security audits, integration management, and workspace administration.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of integrations to return in a single request. Defaults to 100 if not specified. Valid range is typically 1-500. Use smaller values (10-50) for faster responses when you only need a few integrations, or larger values (100-500) when bulk processing.
>
> **cursor** `string`
>
> Pagination cursor for retrieving the next page of results. Use the 'nextCursor' value from a previous response to get subsequent pages. Leave as None/null for the first page. Enables efficient pagination through large numbers of integrations without missing or duplicating entries.
>
> **workspaceId** `string` *required*
>
> Unique workspace identifier to list integrations for (format: 'wksp\_xxxxx'). Must be a workspace the authenticated user has access to. All integrations belonging to this workspace will be returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Prisma Workspaces
>
> **Slug:** `PRISMA_LIST_WORKSPACES`
>
> Retrieve paginated list of Prisma workspaces accessible to authenticated user. Returns workspace IDs, names, creation timestamps with cursor-based pagination. Use for workspace discovery, UI selection flows, and administrative operations.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of workspaces to return in a single request. Defaults to 100 if not specified. Valid range is typically 1-500. Use smaller values (10-50) for faster responses when you only need a few workspaces, or larger values (100-500) when bulk processing. The API may return fewer results than requested if fewer workspaces exist.
>
> **cursor** `string`
>
> Pagination cursor for retrieving the next page of results. Use the 'nextCursor' value from a previous response to get subsequent pages. Leave as None/null for the first page. This enables efficient pagination through large numbers of workspaces without missing or duplicating entries.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Poll Agent Approval
>
> **Slug:** `PRISMA_POLL_AGENT_APPROVAL`
>
> Poll an approval for the authenticated agent to await the sponsor's decision. Only the agent the approval belongs to can read it. Inspect the returned status before retrying an operation that returned approval\_required.
>
> #### Input Parameters
>
> **approvalId** `string` *required*
>
> ID of the approval to poll.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Restore Database Backup
>
> **Slug:** `PRISMA_RESTORE_BACKUP`
>
> Restore database backup to new database instance. Creates new database from existing backup with specified name. Operation is asynchronous - monitor the returned database status for completion. Restoration may take several minutes.
>
> #### Input Parameters
>
> **backupId** `string` *required*
>
> Unique backup identifier to restore. Must be a completed backup from the specified database. Use list\_backups action to find available backup IDs.
>
> **databaseId** `string` *required*
>
> Unique source database identifier containing the backup (format: 'db\_xxxxx'). Must be a database the authenticated user has access to. The backup will be restored from this database's backup collection.
>
> **targetDatabaseName** `string` *required*
>
> Name for the new database created from backup restoration. This will be displayed in UIs and used for identification. Choose descriptive names like 'Restored DB 2025-01-20', 'Production Rollback', etc.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Restore Database
>
> **Slug:** `PRISMA_RESTORE_DATABASE`
>
> Destructively overwrite all target database data with a specified backup. This immediately and irreversibly replaces all data in the existing target; data written since the backup was taken is lost. Ensure you have a recent target backup before proceeding. Connections and credentials are preserved. Restore is asynchronous: status remains recovering until it completes.
>
> #### Input Parameters
>
> **source** `object` *required*
>
> Backup source, including type, source database ID and backup ID.
>
> **targetDatabaseId** `string` *required*
>
> ID of the existing target database whose data will be overwritten.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Revoke Integration Tokens
>
> **Slug:** `PRISMA_REVOKE_INTEGRATION_TOKENS`
>
> Revoke integration tokens for the specified client in the specified workspace. Returns a tool-local success acknowledgment after the provider accepts the revocation with no response body.
>
> #### Input Parameters
>
> **clientId** `string` *required*
>
> Client ID of the integration whose tokens to revoke in the specified workspace.
>
> **workspaceId** `string` *required*
>
> ID of the workspace containing the integration.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Rotate Connection Credentials
>
> **Slug:** `PRISMA_ROTATE_CONNECTION_CREDENTIALS`
>
> Generate new credentials for an existing Prisma connection. Previous credentials are invalidated on a best-effort basis: revocation is not guaranteed. Update applications to use the returned new connection strings and credentials, and store them securely.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> ID of the connection whose credentials to rotate.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Transfer Prisma Project
>
> **Slug:** `PRISMA_TRANSFER_PROJECT`
>
> Transfer Prisma project ownership to another user's workspace. Transfers project ownership from the current authenticated user to the recipient specified by their OAuth2 access token. This is typically used in partner integrations where databases are provisioned on the partner's workspace and later transferred to end users. The project and all its databases are moved to the recipient's workspace. The current owner loses access unless the new owner explicitly grants it. Requirements: - Valid project ID owned by the current user - Valid OAuth2 access token for the recipient user - Recipient workspace must have sufficient quota for the project
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique project identifier to transfer (format: 'proj\_xxxxx'). Obtain from PRISMA\_LIST\_PROJECTS or PRISMA\_CREATE\_PROJECT response. Must be a project owned by the authenticated user's workspace. After transfer, the current user loses access unless explicitly granted by the new owner.
>
> **recipientAccessToken** `string` *required*
>
> OAuth2 access token of the recipient user who will receive project ownership. This token must be obtained through Prisma's OAuth2 flow for the recipient user. The recipient workspace must have sufficient quota to receive the project. Typically used in partner integrations to transfer provisioned databases to end users.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Bucket
>
> **Slug:** `PRISMA_UPDATE_BUCKET`
>
> Update a bucket's display label, logical identity, or branch. A display name change leaves the provider bucket name, objects, and access keys unchanged. Move the bucket separately from setting or clearing logicalId. To replace an existing logicalId, clear it with null first, then set the new one.
>
> #### Input Parameters
>
> **branchId** `string`
>
> Target branch ID. Mutually exclusive with branchGitName and logicalId.
>
> **bucketId** `string` *required*
>
> ID of the bucket to update.
>
> **logicalId** `string`
>
> Declared identity, unique in its branch. Send null to clear; omit to retain. Cannot accompany a branch move.
>
> **displayName** `string`
>
> New display label; does not change the provider bucket name.
>
> **branchGitName** `string`
>
> Target Git branch name; created if absent. Cannot accompany branchId or logicalId.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Database
>
> **Slug:** `PRISMA_UPDATE_DATABASE`
>
> Update a database's display name, logical identity, or branch. Every database belongs to a branch; null branch selectors cannot detach it. Move the database separately from setting or clearing logicalId. To replace an existing logicalId, clear it with null first, then set the new one.
>
> #### Input Parameters
>
> **name** `string`
>
> New display name for the database.
>
> **branchId** `string`
>
> Target branch ID. Mutually exclusive with branchGitName and logicalId. Null (detach) is rejected.
>
> **logicalId** `string`
>
> Declared identity, unique in its branch. Send null to clear; omit to retain. Cannot accompany a branch move.
>
> **databaseId** `string` *required*
>
> ID of the database to update.
>
> **branchGitName** `string`
>
> Target Git branch name; created if absent. Cannot accompany branchId or logicalId. Null (detach) is rejected.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Project
>
> **Slug:** `PRISMA_UPDATE_PROJECT`
>
> Update an existing Prisma project's display name or settings. Omitted fields are not sent. Returns the updated project metadata and its containing workspace.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> ID of the project to update.
>
> **name** `string`
>
> New project display name. Omit to leave the name unchanged.
>
> **settings** `object`
>
> Project settings object. Omit to leave settings unchanged.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
