---
title: "Update an LLM Observability experiment"
method: PATCH
path: "/api/v2/llm-obs/v1/experiments/{experiment_id}"
tags: ["LLM Observability"]
---

# Update an LLM Observability experiment

`PATCH /api/v2/llm-obs/v1/experiments/{experiment_id}`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/llm-obs/v1/experiments/{experiment_id}`
- Auth: API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`

Partially update an existing LLM Observability experiment.

## Path parameters

- `experiment_id` string, required

## Request body

- LLMObsExperimentUpdateRequest: Request to partially update an LLM Observability experiment.
  - `data` LLMObsExperimentUpdateDataRequest, required: Data object for updating an LLM Observability experiment.
    - `attributes` LLMObsExperimentUpdateDataAttributesRequest, required: Attributes for updating an LLM Observability experiment.
      - `dataset_id` string: Updated identifier of the dataset used in this experiment.
      - `description` string: Updated description of the experiment.
      - `error` string: Error message describing why the experiment failed, if applicable.
      - `metadata` object: Updated arbitrary metadata associated with the experiment.
      - `name` string: Updated name of the experiment.
      - `status` 'running' | 'completed' | 'failed' | 'interrupted': Execution status of an LLM Observability experiment.
    - `type` 'experiments', required: Resource type of an LLM Observability experiment.

## Response `200`

OK

- LLMObsExperimentResponse: Response containing a single LLM Observability experiment.
  - `data` LLMObsExperimentDataResponse, required: Data object for an LLM Observability experiment.
    - `attributes` LLMObsExperimentDataAttributesResponse, required: Attributes of an LLM Observability experiment.
      - `aggregate_data` object, nullable: Pre-computed aggregate metrics for this experiment run, including eval score distributions, token costs, and error rates.
      - `author` LLMObsExperimentUser: User data for the author of an experiment. Only present when `include[user_data]` is `true`.
        - `email` string: Email address of the user.
        - `handle` string: Username or handle associated with the user's Datadog account.
        - `icon` string: URL of the user's icon.
        - `id` string: Unique identifier of the user.
        - `name` string: Display name of the user.
      - `config` object, nullable, required: Configuration parameters for the experiment.
      - `created_at` string, date-time, required: Timestamp when the experiment was created.
      - `dataset_id` string, required: Identifier of the dataset used in this experiment.
      - `dataset_name` string, nullable: Name of the dataset used in this experiment. Only present when `include[dataset_names]` is `true`.
      - `dataset_version` integer: Version of the dataset used in this experiment.
      - `deleted_at` string, date-time, nullable: Timestamp when the experiment was soft-deleted, if applicable.
      - `description` string, nullable, required: Description of the experiment.
      - `error` string, nullable: Error message describing why the experiment failed, if applicable.
      - `experiment` string: Logical name of the experiment, shared across all runs of the same pipeline.
      - `metadata` object, nullable, required: Arbitrary metadata associated with the experiment.
      - `name` string, required: Name of the experiment.
      - `parent_experiment_id` string, nullable: Identifier of the parent (baseline) experiment this experiment was run against, if any.
      - `project_id` string, required: Identifier of the project this experiment belongs to.
      - `run_count` integer: Expected number of runs for this experiment.
      - `status` 'running' | 'completed' | 'failed' | 'interrupted': Execution status of an LLM Observability experiment.
      - `updated_at` string, date-time, required: Timestamp when the experiment was last updated.
    - `id` string, required: Unique identifier of the experiment.
    - `type` 'experiments', required: Resource type of an LLM Observability experiment.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)