---
title: "Changes to Update a Reason"
method: PATCH
path: "/v3/organizations/{orgId}/reasons/{reasonId}"
---

# Changes to Update a Reason

`PATCH /v3/organizations/{orgId}/reasons/{reasonId}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 34 revisions.

- **2026-10-26** `c250866428e0`: 1 breaking, 9 info
- **2026-10-17** `f7495fe90970`: 2 info
- **2026-10-15** `fad7b15a74a7`: 1 info

## Changes

- **2026-10-26** `c250866428e0`: 1 breaking, 9 info
  - added the pattern `^[^\u0000]*$` to the request property `name`
  - added the new optional request property `audience`
  - added the new optional request property `default_model`
  - added the new optional request property `default_reasoning_effort`
  - added the new optional request property `default_repositories`
  - added the new optional request property `visibility`
  - added the required property `audience` to the response with the `200` status
  - added the required property `default_model` to the response with the `200` status
  - added the required property `default_reasoning_effort` to the response with the `200` status
  - added the required property `default_repositories` to the response with the `200` status
- **2026-10-17** `f7495fe90970`: 2 info
  - added the new optional request property `instructions`
  - added the required property `instructions` to the response with the `200` status
- **2026-10-15** `fad7b15a74a7`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/ara/apis/reason-api/docs/v3/organizations/:orgId/reasons/:reasonId/patch.md) - [API](https://skmtc.dev/ara/apis/reason-api.md) - [Page](https://skmtc.dev/ara/apis/reason-api/changes/v3/organizations/:orgId/reasons/:reasonId/patch)