v8

latestOpenAPI 3.0.0Apache 2.0raw.githubusercontent.com2025-10-165266542.4 MB
DigitalOcean-public.v2-new_Spaces Keys

Update Spaces Access Keys

To update Spaces Access Key, send a PUT or PATCH request to /v2/spaces/keys/$ACCESS_KEY. At the moment, you cannot convert a fullaccess key to a scoped key or vice versa. You can only update the name of the key.

put/v2/spaces/keys/{access_key}

Path parameters

access_keystring required

The access key's ID.

Request body

namestring

The access key's name.

access_keystring

The Access Key ID used to access a bucket.

created_atstring date-time

The date and time the key was created.

Example request

{
  "name": "my-access-key",
  "grants": [
    {
      "bucket": "my-bucket",
      "permission": "read"
    }
  ],
  "access_key": "DOACCESSKEYEXAMPLE",
  "created_at": "2018-07-19T15:04:16Z"
}

Response

The response will be a JSON object

Example response

{
  "key": {
    "name": "my-access-key",
    "grants": [
      {
        "bucket": "my-bucket",
        "permission": "read"
      }
    ],
    "access_key": "DOACCESSKEYEXAMPLE",
    "created_at": "2018-07-19T15:04:16Z"
  }
}