---
title: "Live-ping a destination through the full transport envelope"
method: POST
path: "/v1/delivery/destinations/{id}/test"
tags: ["Delivery"]
---

# Live-ping a destination through the full transport envelope

`POST /v1/delivery/destinations/{id}/test`

## Request

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

Exercises the complete delivery envelope (SSRF guard, payload cap, rate
limit, retry ladder is disabled — `max_attempts: 1`) with a tiny test
payload. The returned `success` field reflects whether the connector's
`deliver()` call returned a non-retryable success; check `httpStatus`
and `message` for details.

## Path parameters

- `id` string, uuid, required

## Response `200`

Test outcome. Returned regardless of whether the ping succeeded.

- TestConnectionResponse
  - `success` boolean, required
  - `httpStatus` integer, nullable
  - `durationMs` integer, required
  - `message` string, nullable

## Other responses

- `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)