---
title: "Update Organization"
method: PUT
path: "/api/v2/organizations/{organization_id}"
tags: ["Organizations"]
---

# Update Organization

`PUT /api/v2/organizations/{organization_id}`

#### Allowed For

* Admins
* Agents

Agents with no permissions restrictions can only update "notes" on organizations.

**Note:** Updating an organization's `domain_names` property overwrites all existing `domain_names` values. To prevent this, submit a complete list of `domain_names` for the organization in your request.

#### Example Request

```js
{
  "organization": {
    "notes": "Something interesting"
  }
}
```

## Response `200`

Success response

- OrganizationResponse
  - `organization` OrganizationObject
    - `created_at` string — The time the organization was created
    - `details` string, nullable — Any details obout the organization, such as the address
    - `domain_names` string[] — An array of domain names associated with this organization
    - `external_id` string, nullable — A unique external id to associate organizations to an external record. The id is case-insensitive. For example, "company1" and "Company1" are considered the same
    - `group_id` integer, nullable — New tickets from users in this organization are automatically put in this group
    - `id` integer — Automatically assigned when the organization is created
    - `name` string, required — A unique name for the organization
    - `notes` string, nullable — Any notes you have about the organization
    - `organization_fields` object, nullable — Custom fields for this organization. See [Custom organization fields](/api-reference/ticketing/organizations/organizations/#custom-organization-fields)
    - `shared_comments` boolean — End users in this organization are able to comment on each other's tickets
    - `shared_tickets` boolean — End users in this organization are able to see each other's tickets
    - `tags` string[] — The tags of the organization
    - `updated_at` string — The time of the last update of the organization
    - `url` string — The API url of this organization

## Other responses

- `429` — Too Many Requests

---

[API](https://skmtc.dev/botbrains-io/apis/support-api.md) · [All operations](https://skmtc.dev/botbrains-io/apis/support-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/botbrains-io/support-api/revisions/d53eac07ba68/schema)