---
title: "Update Agent Otel Settings"
method: PATCH
path: "/settings/agent-otel"
tags: ["settings"]
---

# Update Agent Otel Settings

`PATCH /settings/agent-otel`

## Request

- Base URL: `https://platform.tracecat.com/api`
- URL: `https://platform.tracecat.com/api/settings/agent-otel`
- Auth: API key in cookie `fastapiusersauth`

## Request body

- AgentOtelSettingsUpdate
  - `agent_otel_config` AgentOtelConfig: Organization-scoped Claude Code OTel configuration. See https://code.claude.com/docs/en/monitoring-usage for the env vars these fields map onto.
    - `enabled` boolean: Whether Claude Code telemetry is enabled for agent runs.
    - `endpoint` string, uri, nullable: OTLP collector endpoint for all signals.
    - `metrics_enabled` boolean: Whether metrics are exported.
    - `logs_enabled` boolean: Whether logs and events are exported.
    - `traces_enabled` boolean: Whether traces are exported. Enables Claude Code beta tracing.
    - `metrics_temporality` 'delta' | 'cumulative', nullable: Metrics aggregation temporality.
    - `metric_export_interval_ms` integer, nullable: Metrics export interval in milliseconds.
    - `logs_export_interval_ms` integer, nullable: Logs export interval in milliseconds.
    - `metrics_include_session_id` boolean, nullable: Whether metrics include the Claude Code session identifier.
    - `metrics_include_version` boolean, nullable: Whether metrics include the Claude Code version.
    - `metrics_include_account_uuid` boolean, nullable: Whether metrics include the authenticated account identifier.
    - `log_user_prompts` boolean, nullable: Whether telemetry includes user prompt content.
    - `log_tool_details` boolean, nullable: Whether telemetry includes tool parameters and input arguments.
    - `log_tool_content` boolean, nullable: Whether telemetry includes tool input and output content.
    - `resource_attributes` object: Resource attributes attached to exported telemetry.
  - `agent_otel_headers` object, nullable: Encrypted headers for the Claude Code OTLP exporter. Omitted values leave existing headers unchanged.

## Response `204`

Successful Response

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tracecat/apis/tracecat-api.md) - [All operations](https://skmtc.dev/tracecat/apis/tracecat-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tracecat/apis/tracecat-api/revisions/2efdda25045f?raw)