Claude Platform Docs

Testar um destino de telemetria

$ ant beta:organization:telemetry-destinations test
POST/v1/organizations/telemetry_destinations/{destination_id}/test

Envia um span de teste, chamado anthropic.test, ao destino com seus cabeçalhos registrados, uma única vez e sem novas tentativas, e relata a resposta do destino. A resposta é 200, quer o destino tenha respondido com um status 2xx ou não: seu result tem o tipo success, ou o tipo failure e o motivo em error. A configuração, o state e o delivery_health do destino não mudam. Um destino desabilitado também pode ser testado. Aguarde 10 segundos entre testes de um mesmo destino; uma solicitação que chegar antes disso pode ser respondida com o status 429.

Parameters
--destination-id: string⁠Path parameter

ID of the destination to test (starts with tdst_).

--beta: optional array of AnthropicBeta⁠Header parameter

This endpoint is in beta: requests must send telemetry-destinations-2026-08-11 in this header.

Returns
beta_telemetry_destination_test_response: object{ type: "telemetry_destination_test", result }

The result of one test span sent to a destination.

type: "telemetry_destination_test"
result: BetaTelemetryDestinationTestSuccess or BetaTelemetryDestinationTestFailure

How the test went: success when the destination answered with a 2xx status, else failure with the reason.

One of the following:
beta_telemetry_destination_test_success: object{ type: "success" }

The destination answered the test span with a 2xx status.

type: "success"
beta_telemetry_destination_test_failure: object{ type: "failure", error }

The test span was not delivered.

type: "failure"
error: string

A message that describes why the test span was not delivered, including the HTTP status code when the destination returned one. Examples: HTTP error (status 403), timeout, TLS failure. It has the same form as the destination's delivery_health.last_error and never contains the destination's response body, any header value, a network address, or TLS details.

Testar um destino de telemetria
ant beta:organization:telemetry-destinations test \
  --api-key my-anthropic-api-key \
  --destination-id destination_id
Returns Examples
Response 200
{
  "result": {
    "type": "success"
  },
  "type": "telemetry_destination_test"
}