Storage

Object Store buckets are S3-compatible file storage that lives inside a Prisma project, next to its Prisma Postgres databases and Compute apps. You manage buckets from the Console, the CLI, or the REST API; your app reads and writes objects with any S3 client or SDK.

A bucket belongs to a project. At creation you can associate it with a branch (by branch ID or git branch name); omit both and it attaches to the project's default branch. Projects start with no buckets.

A bucket has two names:

1. A display name you choose (1-100 characters, auto-generated when omitted). It appears in the Console, CLI, and API.
2. A provider-assigned S3 bucket name, returned as providerName by the API and as bucketName with new access keys. This is the value S3 clients use. It is opaque and never derived from the display name.

There is no rename: the API has no update endpoint for buckets.

Access is through bucket-scoped access keys. A key has a role, read or read_write; a write with a read key fails with AccessDenied. Keys are scoped to their bucket only: a leaked key cannot reach any other bucket.

Creating a key returns everything an S3 client needs: accessKeyId, secretAccessKey, endpoint, and bucketName. The secretAccessKey is returned exactly once and never stored; copy it immediately. If you lose it, revoke the key and create a new one. Deleting a key revokes it immediately.

Use the endpoint value returned with the key rather than hardcoding a host.

Any S3 client or SDK works. On Prisma Compute, Bun's built-in S3 client reads S3_ENDPOINT, S3_BUCKET, S3_ACCESS_KEY_ID, and S3_SECRET_ACCESS_KEY from the environment, so uploads and presigned GET URLs work with no explicit client configuration. See Object storage on Compute for a worked example, and Object storage in Composer for the declarative bucket() resource with local stand-in buckets in dev. For using buckets during development, see Local storage.

From the CLI (see the bucket reference for details):

bunx prisma bucket create --name my-bucket

bunx prisma bucket key create <bucket-id>

pnpm prisma bucket create --name my-bucket
pnpm prisma bucket key create <bucket-id>

yarn prisma bucket create --name my-bucket
yarn prisma bucket key create <bucket-id>

npx prisma bucket create --name my-bucket
npx prisma bucket key create <bucket-id>

The REST API exposes the same operations: list, create, get, and delete buckets, and list, create, and delete access keys. Bucket creation is synchronous; the response comes back with "status": "ready". The Prisma MCP server also carries bucket tools (list_object_store_buckets, create_object_store_bucket, delete_object_store_bucket, create_object_store_bucket_key, delete_object_store_bucket_key) for AI agents.

In the Console, each bucket has a file browser with upload, download, and per-object delete, a keys page with a reveal-once credentials dialog, and a settings page for deletion with type-the-name confirmation.

Deleting a bucket permanently removes the bucket, all objects stored in it, and all its access keys in one call. It succeeds on a non-empty bucket and cannot be undone.

Bucket pricing and plan limits are not published yet.