List Destinations

List all configured delivery destinations for the workspace. Destinations define where processed data is sent: webhook, SFTP, S3, Azure Blob, and more.

Delivery destinations define where Talonic sends processed data and over which transport: an HTTP webhook, SFTP server, S3 bucket, Azure Blob container, Google Drive folder, or OneDrive folder. Destinations are one part of the four-part delivery flow, in which events (carried as *signals* in the API) are matched to bindings (routing rules), resolved into deliverables (payloads), serialized, and sent to destinations.

Each destination is an instance of one of the six supported connector types. A single destination can serve multiple bindings — for example, you might have one S3 destination with separate bindings for extraction results and run outcomes. Auth credentials are stored securely and never returned in API responses.

The list is the health dashboard for your outbound edge: is_active shows whether each destination is currently enabled, and last_delivery_at/last_delivery_status show the most recent attempt against it. A destination that flipped to inactive was auto-disabled by a non-retryable failure (bad credentials, or an SSRF-blocked URL) — inspect it, fix the config, and re-enable via the update endpoint.

• webhook — HTTP POST with optional HMAC-SHA256 signing and idempotency headers.
• sftp — File upload via SSH with password or private key auth.
• s3 — Object upload to AWS S3 with access key auth.
• azure_blob — Blob upload to Azure Storage with connection string or account key.
• google_drive — File upload via OAuth (drive.file scope).
• onedrive — File upload via OAuth (Files.ReadWrite.All scope).

Response

curl -s https://api.talonic.com/v1/delivery/destinations \
  -H "Authorization: Bearer tlnc_your_api_key"

{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Production Webhook",
      "type": "webhook",
      "config": { "url": "https://api.example.com/ingest" },
      "has_auth_config": false,
      "has_signing_secret": true,
      "payload_cap_bytes": null,
      "is_active": true,
      "last_delivery_at": "2024-09-15T11:00:00.000Z",
      "last_delivery_status": "succeeded",
      "created_at": "2024-09-01T10:00:00.000Z",
      "updated_at": "2024-09-01T10:00:00.000Z"
    },
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "name": "Data Lake",
      "type": "s3",
      "config": { "bucket": "talonic-output", "prefix": "invoices/" },
      "has_auth_config": true,
      "has_signing_secret": false,
      "payload_cap_bytes": null,
      "is_active": true,
      "last_delivery_at": null,
      "last_delivery_status": null,
      "created_at": "2024-09-05T14:30:00.000Z",
      "updated_at": "2024-09-05T14:30:00.000Z"
    }
  ]
}

Errors