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

idstring uuid required
Example:a1b2c3d4-e5f6-7890-abcd-ef1234567890

Resource UUID.

Request body

namestring
configobject
signing_secretstring nullable

Set or rotate the HMAC signing secret; null clears it.

payload_cap_bytesinteger nullable
is_activeboolean

Response

Destination updated.

idstring uuid required
customer_idstring uuid required
namestring required
typestring required

Connector type discriminant — resolves to a registered connector. Live types are webhook, sftp, s3, azure_blob, google_drive, onedrive, google_sheets.

configobject

Connector-specific configuration (e.g. { url, headers } for webhook).

has_auth_configboolean

True when connector credentials are stored for this destination. The credential values themselves are never returned.

has_signing_secretboolean

True when an HMAC signing secret is stored. The secret itself is never returned.

payload_cap_bytesinteger nullable

Per-destination override of the TransportWrapper payload cap (bytes).

is_activeboolean required
last_delivery_atstring date-time nullable
last_delivery_statusstring nullable
created_atstring date-time required
updated_atstring date-time required

Example response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "customer_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "Analytics webhook",
  "type": "webhook",
  "last_delivery_at": "2026-04-25T14:30:00.000Z",
  "created_at": "2026-04-25T14:30:00.000Z",
  "updated_at": "2026-04-25T14:30:00.000Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.