Get / Update / Delete / Test

Get destination details, update config, delete a destination, or send a test payload to verify connectivity. Auth credentials are always redacted in responses.

Manage a single destination: retrieve its current config, update transport settings or credentials, delete it, or test connectivity. The test endpoint probes the destination without delivering real data — file-drop connectors (S3, SFTP, Azure Blob) verify bucket/container reachability without writing any objects.

Use GET to inspect current config and delivery status. Use PUT to rotate credentials or change the target URL/bucket. Use POST /test after updating credentials to verify the new config works before live traffic flows through it. Use DELETE only when permanently removing a destination.

The GET response includes last_delivery_at and last_delivery_status to show the most recent delivery attempt. The is_active flag indicates whether the destination is enabled — destinations are automatically disabled on auth_failed or ssrf_blocked errors. The test endpoint returns success, durationMs, and an optional message describing what was probed.

If a destination becomes inactive due to auth failure, fix the credentials via PUT, then call the test endpoint to verify. The destination will be re-enabled automatically on a successful update. Prefer disabling (is_active: false via PUT) over deleting when you want to pause delivery but keep the history.

Response

{
  "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"
}

Errors

Response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "Production Webhook (updated)",
  "type": "webhook",
  "config": { "url": "https://api.example.com/ingest-v2" },
  "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-16T08:00:00.000Z"
}

Errors

Response

{
  "deleted": true
}

Errors

Response

{
  "success": true,
  "durationMs": 142,
  "message": "bucket 'talonic-output' reachable"
}

Errors