API Reference

R2

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Temporary Credentials

Create Temporary Access Credentials

client.R2.TemporaryCredentials.New(ctx, params) (*TemporaryCredentialNewResponse, error)

POST/accounts/{account_id}/r2/temp-access-credentials

ModelsExpand Collapse

type TemporaryCredential struct{…}

Bucket string

Name of the R2 bucket.

ParentAccessKeyID string

Access key ID of the parent R2 API token. The temporary credentials cannot exceed this token’s permissions.

Permission TemporaryCredentialPermission

Permissions allowed on the credentials.

One of the following:

const TemporaryCredentialPermissionAdminReadWrite TemporaryCredentialPermission = "admin-read-write"

const TemporaryCredentialPermissionAdminReadOnly TemporaryCredentialPermission = "admin-read-only"

const TemporaryCredentialPermissionObjectReadWrite TemporaryCredentialPermission = "object-read-write"

const TemporaryCredentialPermissionObjectReadOnly TemporaryCredentialPermission = "object-read-only"

TTLSeconds float64

Lifetime of the temporary credentials in seconds, up to 604800 seconds (7 days).

maximum604800

Objects []stringOptional

Optional object paths to scope the credentials to.

Prefixes []stringOptional

Optional prefix paths to scope the credentials to.