Claude Platform Docs

Test a Telemetry Destination

$client->beta->organization->telemetryDestinations->test(string destinationID, ?list<AnthropicBeta> betas): TelemetryDestinationTestResponse
POST/v1/organizations/telemetry_destinations/{destination_id}/test
Requires anthropic-beta: telemetry-destinations-2026-08-11. How to send beta headers

Send one test span, named anthropic.test, to the destination with its registered headers, once and without retries, and report the destination's answer. The response is 200 whether or not the destination answered with a 2xx status: its result has the type success, or the type failure and the reason in error. The destination's configuration, state and delivery_health do not change. A disabled destination can be tested too. Wait 10 seconds between tests of one destination; a request that comes sooner may be answered with status 429.

Parameters
destinationID: string⁠Path parameter

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

betas?: optional list<AnthropicBeta>⁠Header parameter

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

Returns
class TelemetryDestinationTestResponse { $type = 'telemetry_destination_test'; $result; }
"telemetry_destination_test" type
TelemetryDestinationTestResult result

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

Test a Telemetry Destination
<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Anthropic\Client;
use Anthropic\Beta\AnthropicBeta;

$client = new Client(apiKey: 'my-anthropic-api-key');

$betaTelemetryDestinationTestResponse = $client
  ->beta
  ->organization
  ->telemetryDestinations
  ->test('destination_id', betas: [AnthropicBeta::MESSAGE_BATCHES_2024_09_24]);

var_dump($betaTelemetryDestinationTestResponse);
Returns Examples
Response 200
{
  "result": {
    "type": "success"
  },
  "type": "telemetry_destination_test"
}