---
title: Create Temporary Access Credentials
---

[Skip to content](#_top)

[API Reference](https://developers.cloudflare.com/api/go)

[R2](https://developers.cloudflare.com/api/go/resources/r2)

[Temporary Credentials](https://developers.cloudflare.com/api/go/resources/r2/subresources/temporary_credentials)

Copy Markdown

Open in **Claude**Open in **ChatGPT**Open in **Cursor**

---

**Copy Markdown****View as Markdown**

# Create Temporary Access Credentials

client.R2.TemporaryCredentials.New(ctx, params) (\*[TemporaryCredentialNewResponse](<https://developers.cloudflare.com/api/go/resources/r2#(resource)%20r2.temporary_credentials%20%3E%20(model)%20TemporaryCredentialNewResponse%20%3E%20(schema)>), error)

POST/accounts/{account\_id}/r2/temp-access-credentials

Creates temporary access credentials on a bucket that can be optionally scoped to prefixes or objects.

##### Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. [Create a token](https://developers.cloudflare.com/fundamentals/api/get-started/create-token/).

**Example:**`Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY`

##### ParametersExpand Collapse

<details>

<summary>

params TemporaryCredentialNewParams

</summary>

AccountID param.Field\[string]

Path param: Cloudflare account ID that owns the R2 resource.

maxLength32

<a href="#(resource)%20r2.temporary_credentials%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20account_id">Link to this property</a>

TemporaryCredential param.Field\[<a href="https://developers.cloudflare.com/api/go/resources/r2#(resource)%20r2.temporary_credentials%20%3E%20(model)%20temporary_credential%20%3E%20(schema)">TemporaryCredential</a>]

Body param

<a href="#(resource)%20r2.temporary_credentials%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20temporary_credential">Link to this property</a>

</details>

[Link to this property](<#(resource)%20r2.temporary_credentials%20%3E%20(method)%20create%20%3E%20(params)%20default>)

##### ReturnsExpand Collapse

<details>

<summary>

type TemporaryCredentialNewResponse struct{…}

</summary>

AccessKeyID stringOptional

ID for new access key.

<a href="#(resource)%20r2.temporary_credentials%20%3E%20(model)%20TemporaryCredentialNewResponse%20%3E%20(schema)%20%3E%20(property)%20accessKeyId">Link to this property</a>

SecretAccessKey stringOptional

Secret access key.

<a href="#(resource)%20r2.temporary_credentials%20%3E%20(model)%20TemporaryCredentialNewResponse%20%3E%20(schema)%20%3E%20(property)%20secretAccessKey">Link to this property</a>

SessionToken stringOptional

Security token.

<a href="#(resource)%20r2.temporary_credentials%20%3E%20(model)%20TemporaryCredentialNewResponse%20%3E%20(schema)%20%3E%20(property)%20sessionToken">Link to this property</a>

</details>

[Link to this property](<#(resource)%20r2.temporary_credentials%20%3E%20(model)%20TemporaryCredentialNewResponse%20%3E%20(schema)>)

### Create Temporary Access Credentials

Go

HTTPTypeScriptPythonGoTerraform

```
package main

import (
  "context"
  "fmt"

  "github.com/cloudflare/cloudflare-go"
  "github.com/cloudflare/cloudflare-go/option"
  "github.com/cloudflare/cloudflare-go/r2"
)

func main() {
  client := cloudflare.NewClient(
    option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
  )
  temporaryCredential, err := client.R2.TemporaryCredentials.New(context.TODO(), r2.TemporaryCredentialNewParams{
    AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"),
    TemporaryCredential: r2.TemporaryCredentialParam{
      Bucket: cloudflare.F("example-bucket"),
      ParentAccessKeyID: cloudflare.F("example-access-key-id"),
      Permission: cloudflare.F(r2.TemporaryCredentialPermissionObjectReadWrite),
      TTLSeconds: cloudflare.F(3600.000000),
    },
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", temporaryCredential.AccessKeyID)
}
```

200 example

```
{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    "string"
  ],
  "result": {
    "accessKeyId": "example-access-key-id",
    "secretAccessKey": "example-secret-key",
    "sessionToken": "example-session-token"
  },
  "success": true
}
```

##### Returns Examples

200 example

```
{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    "string"
  ],
  "result": {
    "accessKeyId": "example-access-key-id",
    "secretAccessKey": "example-secret-key",
    "sessionToken": "example-session-token"
  },
  "success": true
}
```