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

r2.temporary_credentials.create(TemporaryCredentialCreateParams**kwargs) -> TemporaryCredentialCreateResponse

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

ModelsExpand Collapse

class TemporaryCredential: …

bucket: str

Name of the R2 bucket.

parent_access_key_id: str

The parent access key id to use for signing.

permission: Literal["admin-read-write", "admin-read-only", "object-read-write", "object-read-only"]

Permissions allowed on the credentials.

One of the following:

"admin-read-write"

"admin-read-only"

"object-read-write"

"object-read-only"

ttl_seconds: float

How long the credentials will live for in seconds.

maximum604800

objects: Optional[List[str]]

Optional object paths to scope the credentials to.

prefixes: Optional[List[str]]

Optional prefix paths to scope the credentials to.

class TemporaryCredentialCreateResponse: …

access_key_id: Optional[str]

ID for new access key.

secret_access_key: Optional[str]

Secret access key.

session_token: Optional[str]

Security token.