---
title: "Update a delivery destination"
method: PUT
path: "/v1/delivery/destinations/{id}"
tags: ["Delivery"]
---

# Update a delivery destination

`PUT /v1/delivery/destinations/{id}`

## Request

- Base URL: `https://api.talonic.com`
- URL: `https://api.talonic.com/v1/delivery/destinations/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, uuid, required

## Request body

- UpdateDestinationRequest: Partial update — every field optional. Only supplied fields are written.
  - `name` string
  - `config` object
  - `auth_config` union: Replaces the stored credentials. `auth_config.signing_secret` is lifted onto the destination's signing secret exactly as on create.
    - union: Destination credential payload. Write-only — server responses expose only `has_auth_config: boolean`, never the credential values themselves. The `type` field discriminates the concrete shape; valid values depend on the parent destination's connector `type` (see `/v1/delivery/catalog/connectors` for each connector's `auth_types`).
      - AuthConfigPassword: SFTP password auth.
        - `type` 'password', required
        - `password` string, required
      - AuthConfigPrivateKey: SFTP key-based auth. `passphrase` is optional.
        - `type` 'private_key', required
        - `private_key` string, required
        - `passphrase` string, nullable
      - AuthConfigAccessKey: S3 IAM access-key pair. `session_token` is optional (STS).
        - `type` 'access_key', required
        - `access_key_id` string, required
        - `secret_access_key` string, required
        - `session_token` string, nullable
      - AuthConfigConnectionString: Azure Blob Storage connection string auth.
        - `type` 'connection_string', required
        - `connection_string` string, required
      - AuthConfigAccountKey: Azure Blob Storage shared-key auth (`account_name` lives in the destination `config`).
        - `type` 'account_key', required
        - `account_key` string, required
      - AuthConfigBearer: Webhook Bearer-token auth. Emits `Authorization: Bearer {token}`.
        - `type` 'bearer', required
        - `token` string, required
      - AuthConfigBasic: Webhook HTTP Basic auth. Emits `Authorization: Basic base64(username:password)`.
        - `type` 'basic', required
        - `username` string
        - `password` string
      - AuthConfigApiKey: Webhook API-key auth. Header name defaults to `X-API-Key`.
        - `type` 'api_key', required
        - `api_key` string, required
        - `header_name` string
      - AuthConfigNone: Explicit "no authentication" marker.
        - `type` 'none', required
    - object
  - `signing_secret` string, nullable: Set or rotate the HMAC signing secret; `null` clears it.
  - `payload_cap_bytes` integer, nullable
  - `is_active` boolean

## Response `200`

Destination updated.

- Destination
  - `id` string, uuid, required
  - `customer_id` string, uuid, required
  - `name` string, required
  - `type` string, required: Connector type discriminant — resolves to a registered connector. Live types are `webhook`, `sftp`, `s3`, `azure_blob`, `google_drive`, `onedrive`, `google_sheets`.
  - `config` object: Connector-specific configuration (e.g. `{ url, headers }` for webhook).
  - `has_auth_config` boolean: True when connector credentials are stored for this destination. The credential values themselves are never returned.
  - `has_signing_secret` boolean: True when an HMAC signing secret is stored. The secret itself is never returned.
  - `payload_cap_bytes` integer, nullable: Per-destination override of the TransportWrapper payload cap (bytes).
  - `is_active` boolean, required
  - `last_delivery_at` string, date-time, nullable
  - `last_delivery_status` string, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `400`: The request is invalid.
- `401`: Missing or invalid API key.
- `404`: The requested resource was not found.
- `429`: Daily rate limit exceeded.

---

[API](https://skmtc.dev/talonic/apis/talonic-api.md) · [All operations](https://skmtc.dev/talonic/apis/talonic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/talonic/apis/talonic-api/revisions/678fe5f8c9c3?raw)