# Endpoints

::::card-grid
:::card{title="Delete database" href="/guides/endpoints-databases-delete-databases-by-database-id"}
REST API: Deletes the database with the given ID.
:::

:::card{title="Get database" href="/guides/endpoints-databases-get-databases-by-database-id"}
REST API: Returns the database with the given ID.
:::

:::card{title="List databases" href="/guides/endpoints-databases-get-databases"}
REST API: Returns all databases the token has access to. Optionally filter by project ID.
:::

:::card{title="Get list of databases" href="/guides/endpoints-databases-get-projects-by-project-id-databases"}
REST API: Returns databases for the given project.
:::

:::card{title="Update database" href="/guides/endpoints-databases-patch-databases-by-database-id"}
REST API: Updates the database with the given ID. logicalId cannot be combined with branchId or branchGitName in one request; move the database first, then set its logicalId.
:::

:::card{title="Restore database (destructive)" href="/guides/endpoints-databases-post-databases-by-target-database-id-restore"}
REST API: Destructive operation — this immediately and irreversibly overwrites all data in the target database with the contents of the specified backup. Any data written since the backup was taken will be lost. Ensure you have a recent backup of the target database before proceeding. Replaces the data in an existing database from a backup. Connections and credentials are preserved — only the data layer is replaced.
:::

:::card{title="Create database" href="/guides/endpoints-databases-post-databases"}
REST API: Creates a new database in the specified project. logicalId cannot be combined with branchGitName; pass branchId instead.
:::

:::card{title="Create database" href="/guides/endpoints-databases-post-projects-by-project-id-databases"}
REST API: Creates a new database for the given project.
:::

:::card{title="Get list of backups" href="/guides/endpoints-database-backups-get-databases-by-database-id-backups"}
REST API: Returns backups for the specified database.
:::

:::card{title="Get database usage metrics" href="/guides/endpoints-database-usage-get-databases-by-database-id-usage"}
REST API: Returns usage metrics for the specified database.
:::

:::card{title="Get list of database connections" href="/guides/endpoints-databases-connections-get-databases-by-database-id-connections"}
REST API: Returns all connections for the given database.
:::

:::card{title="Create database connection string" href="/guides/endpoints-databases-connections-post-databases-by-database-id-connections"}
REST API: Creates a new connection string for the given database.
:::

:::card{title="Delete integration" href="/guides/endpoints-integrations-delete-integrations-by-id"}
REST API: Revokes the integration tokens by integration ID.
:::

:::card{title="Revoke integration tokens" href="/guides/endpoints-integrations-delete-workspaces-by-workspace-id-integrations-by-client-id"}
REST API: Revokes the integration tokens with the given client ID.
:::

:::card{title="Get integration by ID" href="/guides/endpoints-integrations-get-integrations-by-id"}
REST API: Returns a single integration by its ID.
:::

:::card{title="Get list of integrations" href="/guides/endpoints-integrations-get-integrations"}
REST API: Returns integrations filtered by workspace ID.
:::

:::card{title="Get list of integrations" href="/guides/endpoints-integrations-get-workspaces-by-workspace-id-integrations"}
REST API: Returns integrations for the given workspace.
:::

:::card{title="Delete project" href="/guides/endpoints-projects-delete-projects-by-id"}
REST API: Deletes the project with the given ID.
:::

:::card{title="Get project" href="/guides/endpoints-projects-get-projects-by-id"}
REST API: Returns the project with the given ID.
:::

:::card{title="Get list of projects" href="/guides/endpoints-projects-get-projects"}
REST API: Returns the list of projects the token has access to.
:::

:::card{title="Update project" href="/guides/endpoints-projects-patch-projects-by-id"}
REST API: Updates the project with the given ID.
:::

:::card{title="Transfer project" href="/guides/endpoints-projects-post-projects-by-id-transfer"}
REST API: Transfer the project with the given ID to the new owner's workspace
:::

:::card{title="Create project with a postgres database" href="/guides/endpoints-projects-post-projects"}
REST API: Creates a new project with a postgres database.
:::

:::card{title="Get workspace subscription" href="/guides/endpoints-workspaces-get-workspaces-by-id-subscription"}
REST API: Returns subscription information for the workspace with the given ID.
:::

:::card{title="Get workspace" href="/guides/endpoints-workspaces-get-workspaces-by-id"}
REST API: Returns the workspace with the given ID.
:::

:::card{title="Get list of workspaces" href="/guides/endpoints-workspaces-get-workspaces"}
REST API: Returns the list of workspaces the current token can access.
:::

:::card{title="Delete connection" href="/guides/endpoints-connections-delete-connections-by-id"}
REST API: Deletes the connection with the given ID.
:::

:::card{title="Get connection" href="/guides/endpoints-connections-get-connections-by-id"}
REST API: Returns the connection with the given ID.
:::

:::card{title="List connections" href="/guides/endpoints-connections-get-connections"}
REST API: Returns all connections the actor has access to, with optional database filter.
:::

:::card{title="Rotate connection credentials" href="/guides/endpoints-connections-post-connections-by-id-rotate"}
REST API: Generates new credentials for the connection with the given ID. Revocation of the previous credentials is best-effort.
:::

:::card{title="Create connection" href="/guides/endpoints-connections-post-connections"}
REST API: Creates a new connection for the specified database.
:::

:::card{title="Get all regions" href="/guides/endpoints-regions-get-regions"}
REST API: Returns all available regions across products. Optionally filter by product.
:::

:::card{title="Get current authenticated principal" href="/guides/endpoints-misc-get-me"}
REST API: Returns the user, workspace, and credential represented by the current token.
:::

:::card{title="Get Prisma Accelerate regions" href="/guides/endpoints-misc-get-regions-accelerate"}
REST API: Returns all available regions for Prisma Accelerate.
:::

:::card{title="Get Prisma Postgres regions" href="/guides/endpoints-misc-get-regions-postgres"}
REST API: Returns all available regions for Prisma Postgres.
:::

:::card{title="Delete bucket key" href="/guides/endpoints-buckets-delete-buckets-by-bucket-id-keys-by-key-id"}
REST API: Revokes and deletes the bucket key with the given ID.
:::

:::card{title="Delete bucket" href="/guides/endpoints-buckets-delete-buckets-by-bucket-id"}
REST API: Permanently deletes the bucket with the given ID, all objects stored in it, and all its access keys. This action cannot be undone.
:::

:::card{title="List bucket keys" href="/guides/endpoints-buckets-get-buckets-by-bucket-id-keys"}
REST API: Returns all access keys for the given bucket.
:::

:::card{title="Get bucket" href="/guides/endpoints-buckets-get-buckets-by-bucket-id"}
REST API: Returns the bucket with the given ID.
:::

:::card{title="List buckets" href="/guides/endpoints-buckets-get-buckets"}
REST API: Returns all object-store buckets the token has access to. Optionally filter by project ID.
:::

:::card{title="Update bucket" href="/guides/endpoints-buckets-patch-buckets-by-bucket-id"}
REST API: Updates the display name, logical id, or branch of the bucket with the given ID. The display name is a label only: the provider bucket name, the objects, and the access keys do not change. logicalId cannot be combined with branchId or branchGitName in one request; move the bucket first, then set its logicalId.
:::

:::card{title="Create bucket key" href="/guides/endpoints-buckets-post-buckets-by-bucket-id-keys"}
REST API: Creates a new access key for the given bucket. The secretAccessKey field is returned exactly once in this response and is never stored — copy it immediately.
:::

:::card{title="Create bucket" href="/guides/endpoints-buckets-post-buckets"}
REST API: Creates a new object-store bucket in the specified project.
:::

:::card{title="Delete service token" href="/guides/endpoints-service-tokens-delete-workspaces-by-workspace-id-service-tokens-by-service-token-id"}
REST API: Revokes the service token with the given ID by deleting it.
:::

:::card{title="List service tokens" href="/guides/endpoints-service-tokens-get-workspaces-by-workspace-id-service-tokens"}
REST API: Returns the service tokens for the given workspace, newest first.
:::

:::card{title="Create service token" href="/guides/endpoints-service-tokens-post-workspaces-by-workspace-id-service-tokens"}
REST API: Creates a new service token for the given workspace. The value field is returned exactly once in this response and is never stored — copy it immediately.
:::

:::card{title="Poll an approval" href="/guides/endpoints-agents-get-agent-approvals-by-approval-id"}
REST API: Reports where an approval stands, so an agent holding an approval\_required response can wait for the sponsor's decision and retry. Only the agent the approval belongs to can read it.
:::
::::

## Related pages

- [Authentication & Tools](./authentication-tools-index.md)
- [Build](./build-index.md)
- [Changelog](../changelog.md)
- [Concepts](./concepts-index.md)
- [Console commands](./console-commands-index.md)
- [Contract Authoring](./contract-authoring-index.md)
- [Core Concepts](./core-concepts-index.md)
- [Data Modeling](./data-modeling-index.md)
- [Database](./database-index.md)
- [DB commands](./db-commands-index.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.
