Claude Platform Docs

Telemetrieziel testen

POST/v1/organizations/telemetry_destinations/{destination_id}/test

Sendet einen Test-Span namens anthropic.test mit den registrierten Headern an das Ziel, einmalig und ohne Wiederholungen, und meldet die Antwort des Ziels. Die Antwort ist 200, unabhängig davon, ob das Ziel mit einem 2xx-Status geantwortet hat: Ihr result hat den Typ success oder den Typ failure mit dem Grund in error. Die Konfiguration, state und delivery_health des Ziels ändern sich nicht. Auch ein deaktiviertes Ziel kann getestet werden. Warte 10 Sekunden zwischen Tests desselben Ziels; eine früher eintreffende Anfrage kann mit Status 429 beantwortet werden.

Path parameters
destination_id: string

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

Headers
"anthropic-version": optional string

The version of the Claude API you want to use.

Read more about versioning and our version history here.

"anthropic-beta": optional array of AnthropicBeta

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

One of the following:
string
"message-batches-2024-09-24"
"prompt-caching-2024-07-31"
"computer-use-2024-10-22"
"computer-use-2025-01-24"
"pdfs-2024-09-25"
"token-counting-2024-11-01"
"token-efficient-tools-2025-02-19"
"output-128k-2025-02-19"
"files-api-2025-04-14"
"mcp-client-2025-04-04"
"mcp-client-2025-11-20"
"dev-full-thinking-2025-05-14"
"interleaved-thinking-2025-05-14"
"code-execution-2025-05-22"
"extended-cache-ttl-2025-04-11"
"context-1m-2025-08-07"
"context-management-2025-06-27"
"model-context-window-exceeded-2025-08-26"
"skills-2025-10-02"
"fast-mode-2026-02-01"
"output-300k-2026-03-24"
"user-profiles-2026-03-24"
"user-profiles-2026-08-18"
"user-profiles-2026-09-04"
"advisor-tool-2026-03-01"
"managed-agents-2026-04-01"
"cache-diagnosis-2026-04-07"
"dreaming-2026-04-21"
"thinking-token-count-2026-05-13"
"server-side-fallback-2026-06-01"
"server-side-fallback-2026-07-01"
"fallback-credit-2026-06-01"
"fallback-credit-2026-07-01"
"agent-memory-2026-07-22"
"mid-conversation-tool-changes-2026-07-01"
"compact-2026-01-12"
"computer-use-2025-11-24"
"mcp-tunnels-2026-06-22"
"structured-outputs-2025-11-13"
"task-budgets-2026-03-13"
"thinking-display-updates-2026-08-18"
"ce-user-management-2026-07-13"
"mid-conversation-output-config-2026-07-01"
"thinking-binding-controls-2026-08-01"
"mid-conversation-system-clear-at-2026-08-21"
"compact-2026-09-04"
"inline-tools-2026-09-15"
"mcp-client-2026-09-15"
"ce-plugins-2026-09-01"
"spend-limit-reads-2026-09-26"
"telemetry-destinations-2026-08-11"
Returns
BetaTelemetryDestinationTestResponse object{ type: "telemetry_destination_test", result }

The result of one test span sent to a destination.

type: "telemetry_destination_test"

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

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

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

type: "success"
BetaTelemetryDestinationTestFailure 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.

Telemetrieziel testen
curl https://api.anthropic.com/v1/organizations/telemetry_destinations/$DESTINATION_ID/test \
    -X POST \
    -H 'anthropic-version: 2023-06-01' \
    -H 'anthropic-beta: telemetry-destinations-2026-08-11' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY"
Returns Examples
Response 200
{
  "result": {
    "type": "success"
  },
  "type": "telemetry_destination_test"
}