For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.

Update an Agent Analytics dataset

Updates dataset metadata. Absent fields are unchanged; an explicit null
clears description. id, agent_name, and source_type are immutable —
create a new dataset to change the agent scope.

patch/v1/projects/{project_id}/agent-analytics/datasets/{dataset_id}

Authorizations

Authorizationstringrequired

http

Path parameters

project_idstringrequired

Amplitude project identifier, backed by the canonical app ID.

Example:12345
Constraints:pattern: ^[0-9]+$
dataset_idstringrequired

Stable dataset identifier, returned by create or by the Agent Analytics read surface.

Header parameters

Idempotency-Keystringrequired

Unique idempotency key used to safely retry write operations.

Constraints:min length: 8max length: 255

Body

application/json
namestring
Constraints:min length: 1max length: 255
descriptionstring
Constraints:nullable

Response

application/json
200· Updated dataset.
dataobjectrequired
Show child attributes
idstringrequired

Stable dataset identifier (ULID).

objectstringrequired
project_idstringrequired
namestringrequired
Constraints:min length: 1
descriptionstringrequired
Constraints:nullable
agent_namestringrequired

Agent the dataset is scoped to. Null for project-level datasets.

Constraints:nullable
source_typestringrequired

How the dataset was assembled, such as manual.

session_countintegerrequired

Sessions currently in the dataset.

reviewed_countintegerrequired

Sessions in the dataset that carry a human review.

created_atstringrequired
Constraints:format: date-time
created_bystring
Constraints:nullable

Was this helpful?