---
search:
  tags:
    - console-backup
    - PUT
seo:
  description: >-
    Changes the name, and the settings or the credentials… Reference for the PUT
    /api/v1/console-backup/targets/{id} endpoint in the TimescaleDB Enterprise
    API.
  noindex: true
sidebar:
  label: Change a backup target
  badge: PUT
title: Change a backup target
type: openapi-operation
---
Changes the name, and the settings or the credentials of an s3 target. The kind does not change. New settings or credentials set up the marker again, in the new place.

`PUT /api/v1/console-backup/targets/{id}`

**Request body** (`application/json`, required)

- `name` (string, required)
- `secrets` (BackupTargetSecretsBody) — The new credentials. Not set: the stored credentials do not change
- `settings` (BackupTargetSettingsBody) — The new settings. Not set: the settings do not change

Request body example:

```json
{
  "name": "string",
  "secrets": {
    "s3": {
      "access_key_id": "string",
      "secret_access_key": "string",
      "session_token": "string"
    }
  },
  "settings": {
    "s3": {
      "bucket": "string",
      "ca_bundle": "string",
      "endpoint": "string",
      "path_style": true,
      "prefix": "string",
      "region": "string"
    }
  }
}
```

**Responses**

- `200` — OK
- `default` — Error

Response example, 200:

```json
{
  "created_at": "2019-08-24T14:15:22Z",
  "id": "string",
  "kind": "local",
  "name": "string",
  "secrets_set": true,
  "settings": {
    "s3": {
      "bucket": "string",
      "ca_bundle": "string",
      "endpoint": "string",
      "path_style": true,
      "prefix": "string",
      "region": "string"
    }
  },
  "updated_at": "2019-08-24T14:15:22Z"
}
```
