---
title: "Update an existing Dataset"
method: PUT
path: "/policies/dataset/{id}"
tags: ["dataset"]
---

# Update an existing Dataset

`PUT /policies/dataset/{id}`

## Request body

- DatasetUpdateReqSchema
  - `name` string — A unique name label
  - `sink_ids` string[] — An array of one or more sink unique identifier

## Response `201`

Policy object

- DatasetObjSchema
  - `id` string, uuid, required — Unique identifier (UUID)
  - `name` string — A unique name label
  - `agent_group_id` string, uuid — Unique identifier (UUID) of an agent_group
  - `agent_policy_id` string, uuid — Unique identifier (UUID) of an agent_policy
  - `sink_ids` string[] — An array of one or more sink unique identifier
  - `valid` boolean — Boolean field indicating whether the dataset is valid
  - `tags` object — User defined key/values for organization and searching
  - `ts_created` string, date-time — Timestamp of creation

## Other responses

- `400` — Failed due to malformed JSON.
- `401` — Missing or invalid access token provided.
- `422` — Databse can't process request.
- `500` — Unexpected server-side error occurred.

## Changes

- **2026-07-17** `d95ee7691efb` — 2 breaking, 1 warning
  - added the new required `header` request parameter `Authorization` to all path's operations
  - added the new required `header` request parameter `Authorization`
  - deleted the `header` request parameter `Bearer authorization`
- **2022-10-04** `ce59b3bdec00` — 2 breaking, 1 warning
  - added the new required `header` request parameter `Bearer authorization` to all path's operations
  - added the new required `header` request parameter `Bearer authorization`
  - deleted the `header` request parameter `Authorization`
- **2022-05-06** `9309037e46b9` — 2 warning, 2 info
  - removed the request property `sink_id`
  - removed the optional property `sink_id` from the response with the `201` status
  - added the new optional request property `sink_ids`
  - added the optional property `sink_ids` to the response with the `201` status
- **2022-01-12** `b3e28725ccae` — 1 warning
  - removed the request property `tags`
- **2021-09-22** `dc9b53b51fdd` — 3 breaking
  - the `sink_id` request property's minItems was increased to `1`
  - the `sink_id` request property type changed from `string` to `array`, and format from `uuid` to no format
  - the `sink_id` response's property type changed from `string` to `array`, and format from `uuid` to no format for status `201`

[Full history](https://skmtc.dev/orb-community/apis/orb-policies/changes/policies/dataset/:id/put.md)

---

[API](https://skmtc.dev/orb-community/apis/orb-policies.md) · [All operations](https://skmtc.dev/orb-community/apis/orb-policies/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/orb-community/orb-policies/revisions/d95ee7691efb/schema)