Claude Platform Docs

測試遙測目的地

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

將一個名為 anthropic.test 的測試 span 連同已註冊的標頭傳送至目的地，僅傳送一次且不重試，並回報目的地的回應。無論目的地是否以 2xx 狀態回應，回應皆為 200：其 result 的類型為 success，或類型為 failure 並在 error 中附上原因。目的地的設定、state 與 delivery_health 不會變更。已停用的目的地也可以測試。對同一目的地的兩次測試之間請等待 10 秒；過早送出的請求可能會收到狀態 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.

測試遙測目的地
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"
}