Claude Platform Docs

Mettre à jour une destination de télémétrie

$client->beta->organization->telemetryDestinations->update(string destinationID, ?string displayName, ?string endpointURL, ?array<string,string> headers, ?TelemetryDestinationStateParams state, ?TelemetryDestinationTracesParams traces, ?TelemetryDestinationWorkspacesParams workspaces, ?list<AnthropicBeta> betas): TelemetryDestination
POST/v1/organizations/telemetry_destinations/{destination_id}
Requires anthropic-beta: telemetry-destinations-2026-08-11. How to send beta headers

Modifier les paramètres d'une destination de télémétrie, son état ou les espaces de travail qu'elle couvre.

Envoyez au moins un champ. Les champs omis conservent leurs valeurs stockées, à l'exception des en-têtes enregistrés, qui sont supprimés par une modification du nom d'hôte ou du port du point de terminaison. Seuls display_name, traces, traces.endpoint_url, traces.content_mode, traces.max_content_bytes et les valeurs individuelles de headers acceptent null.

Si une autre requête modifie la destination pendant l'exécution de la mise à jour, l'API renvoie une erreur 409 conflict_error. Relisez la destination, puis relancez la mise à jour.

Consultez le guide d'export OpenTelemetry pour en savoir plus sur la modification d'une destination.

Parameters
destinationID: string⁠Path parameter

ID of the destination (tdst_...).

displayName?: optional string

New human-readable name, 1 to 255 characters. Null clears it.

endpointURL?: optional string

The new base URL of the destination's OTLP/HTTP endpoint. The same rules as on create apply.

A change of hostname or port first removes every registered header, so send the headers for the new endpoint in the same request. When the destination has a traces.endpoint_url, such a change must also set traces.endpoint_url to a URL with the new hostname and port, or to null. A change of the path alone keeps the headers.

headers?: optional array<string,string>

Headers to set or remove. The API merges them into the destination's headers by name.

Names compare case-insensitively. A string value sets or replaces that header. A null value removes it. Headers that you omit don't change. The field itself can't be null.

A request that sets a header value must also include endpoint_url. The current URL is accepted.

The resulting set must stay within the same limits as on create. When the request sets a value, each stored value that it doesn't set counts as 4,096 bytes toward the 16,384-byte limit, because you can't read its real length. So to change one header of a destination that has four or more other headers, send the values of the others again in the same request.

state?: optional TelemetryDestinationStateParams

Whether the destination receives deliveries after the update. The field can't be null.

traces?: optional TelemetryDestinationTracesParams

The traces settings to change. Omitted settings keep their stored values.

null sets every traces setting to its create default.

workspaces?: optional TelemetryDestinationWorkspacesParams

The new workspace scope, in the same form as on create. The field can't be null.

The API refuses an update that changes the type or sends workspace_ids while the destination's list has more than 750 workspaces. Remove workspaces one at a time until 750 or fewer remain, then send the update again.

betas?: optional list<AnthropicBeta>⁠Header parameter

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

Returns
class TelemetryDestination { $type = 'telemetry_destination'; $id; $createdAt; /* 8 more */ }
Mettre à jour une destination de télémétrie
<?php

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

use Anthropic\Client;
use Anthropic\Beta\AnthropicBeta;
use Anthropic\Beta\Organization\TelemetryDestinations\TelemetryDestinationContentMode;

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

$betaTelemetryDestination = $client
  ->beta
  ->organization
  ->telemetryDestinations
  ->update(
  'destination_id',
  displayName: 'display_name',
  endpointURL: 'endpoint_url',
  headers: ['foo' => 'string'],
  state: ['type' => 'enabled'],
  traces: [
    'contentMode' => TelemetryDestinationContentMode::METADATA_ONLY,
    'enabled' => true,
    'endpointURL' => 'endpoint_url',
    'maxContentBytes' => 0,
  ],
  workspaces: ['type' => 'all'],
  betas: [AnthropicBeta::MESSAGE_BATCHES_2024_09_24],
);

var_dump($betaTelemetryDestination);
Returns Examples
Response 200
{
  "id": "id",
  "created_at": "2019-12-27T18:11:19.117Z",
  "delivery_health": {
    "last_error": "last_error",
    "last_error_at": "2019-12-27T18:11:19.117Z",
    "last_success_at": "2019-12-27T18:11:19.117Z"
  },
  "display_name": "display_name",
  "endpoint_url": "endpoint_url",
  "header_names": [
    "string"
  ],
  "state": {
    "type": "enabled"
  },
  "traces": {
    "content_mode": "metadata_only",
    "enabled": true,
    "endpoint_url": "endpoint_url",
    "max_content_bytes": 0
  },
  "type": "telemetry_destination",
  "updated_at": "2019-12-27T18:11:19.117Z",
  "workspaces": {
    "type": "all"
  }
}