---
title: "Manage Attribute Options"
method: PUT
path: "/api/inventory/v2/schemas/attributes/{attributeId}/values/{valueId}"
tags: ["Inventory Schema"]
---

# Manage Attribute Options

`PUT /api/inventory/v2/schemas/attributes/{attributeId}/values/{valueId}`

## Request

- Base URL: `https://hostname`
- URL: `https://hostname/api/inventory/v2/schemas/attributes/{attributeId}/values/{valueId}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://{hostname}/api/access/v1/oauth/token` scopes: `INVENTORY`, `INVENTORY_WRITE`

Use this API to manage attribute options in the assessment questions and inventories.

> 🗒 Things to Know
>
> - This API supports deactivating/activating attribute options.
> - This API can also be used for editing option names.

## Path parameters

- `attributeId` string, uuid, required
- `valueId` string, uuid, required

## Request body

- AttributeValueUpdateRequest
  - `AttributeId` string, uuid, required
  - `Value` string, required: Value of the attribute option
  - `Status` 'enabled' | 'disabled': Status of the attribute value
  - `hint` string: Hint text for the attribute value
  - `colorCode` string: Color code for visual representation
  - `selectionValue` string: Selection value for numerical attributes
  - `context` AttributeContext
    - `parameters` object

## Response `200`

OK

- AttributeValueResponse
  - `id` string: Unique identifier of the attribute value
  - `value` string: Value of the attribute option
  - `valueKey` string: Key used for value translation
  - `hint` string: Hint text for the attribute value
  - `hintKey` string: Key used for hint translation
  - `status` 'enabled' | 'disabled': Status of the attribute value
  - `seeded` boolean: Flag indicating if the attribute value is seeded (system-provided)
  - `sequence` integer: Sequence number for ordering
  - `colorCode` string: Color code for visual representation
  - `selectionValue` string: Selection value for numerical attributes

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: Too Many Requests. For more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).
- `500`: Internal Server Error

---

[API](https://skmtc.dev/onetrust/apis/privacy-automation-data-mapping-automation.md) - [All operations](https://skmtc.dev/onetrust/apis/privacy-automation-data-mapping-automation/llms.txt) - [OpenAPI document](https://skmtc.dev/onetrust/apis/privacy-automation-data-mapping-automation/revisions/daead5d9fad6?raw)