---
title: "Update Status Descriptions"
method: PUT
path: "/v1/organizations/organization/status-descriptions"
tags: ["Organisations"]
---

# Update Status Descriptions

`PUT /v1/organizations/organization/status-descriptions`

## Request

- Base URL: `https://client.api.prod.orsay.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://client.api.prod.orsay.ai/v1/organizations/organization/status-descriptions`
- Auth: HTTP bearer

## Request body

- UpdateStatusDescriptionsRequest
  - `builtin_descriptions` StatusDescriptionUpdate[], required
    - `status_id` string, required
    - `description` string, nullable
  - `custom_updates` CustomStatusUpdate[]
    - `id` string, required
    - `description` string, nullable
    - `ai_enabled` boolean
    - `agent_policy` string, nullable

## Response `200`

Successful Response

- StatusDescriptionsResponse
  - `builtin_descriptions` object, required
  - `custom_classifications` CustomClassificationItem[], required
    - `id` string, required
    - `label` string, required
    - `color` string, required
    - `text_color` string, required
    - `description` string, nullable
    - `ai_enabled` boolean
    - `agent_policy` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/orsay/apis/orsay-api.md) - [All operations](https://skmtc.dev/orsay/apis/orsay-api/llms.txt) - [OpenAPI document](https://skmtc.dev/orsay/apis/orsay-api/revisions/988a26cafef5?raw)