---
title: "Create an LLM Observability dataset"
method: POST
path: "/api/v2/llm-obs/v1/{project_id}/datasets"
tags: ["LLM Observability"]
---

# Create an LLM Observability dataset

`POST /api/v2/llm-obs/v1/{project_id}/datasets`

## Request

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

Create a new LLM Observability dataset within the specified project.

## Path parameters

- `project_id` string, required

## Request body

- LLMObsDatasetRequest: Request to create an LLM Observability dataset.
  - `data` LLMObsDatasetDataRequest, required: Data object for creating an LLM Observability dataset.
    - `attributes` LLMObsDatasetDataAttributesRequest, required: Attributes for creating an LLM Observability dataset.
      - `description` string: Description of the dataset.
      - `metadata` object: Arbitrary metadata associated with the dataset.
      - `name` string, required: Name of the dataset.
    - `type` 'datasets', required: Resource type of an LLM Observability dataset.

## Response `200`

OK

- LLMObsDatasetResponse: Response containing a single LLM Observability dataset.
  - `data` LLMObsDatasetDataResponse, required: Data object for an LLM Observability dataset.
    - `attributes` LLMObsDatasetDataAttributesResponse, required: Attributes of an LLM Observability dataset.
      - `created_at` string, date-time, required: Timestamp when the dataset was created.
      - `current_version` integer, required: Current version number of the dataset.
      - `description` string, nullable, required: Description of the dataset.
      - `metadata` object, nullable, required: Arbitrary metadata associated with the dataset.
      - `name` string, required: Name of the dataset.
      - `updated_at` string, date-time, required: Timestamp when the dataset was last updated.
    - `id` string, required: Unique identifier of the dataset.
    - `type` 'datasets', required: Resource type of an LLM Observability dataset.

## Other responses

- `201`: Created
- `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)