---
title: "Update an organisation"
method: PATCH
path: "/v2/organisations/{id}"
tags: ["Gateway GRPC"]
---

# Update an organisation

`PATCH /v2/organisations/{id}`

## Request

- Base URL: `https://api.cautio.in` (the document declares no server; this is the origin it was published from)
- URL: `https://api.cautio.in/v2/organisations/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Request body

- UpdateOrganisationDto
  - `display_name` string: Display name of the organisation
  - `parent_id` string: Parent organisation id
  - `vehicle_ids` string[]: Vehicle IDs to move to the organisation
  - `excluded_user_ids` string[]: List of user IDs to exclude from auto-assignment
  - `is_setup` boolean: Whether first-time setup is complete for this organisation

## Response `200`

The updated organisation

- OrganisationDto
  - `id` string, required: Organisation id
  - `display_name` string, required: Display name of the organisation
  - `parent_id` string: Effective parent organisation id when accessible to the user; omitted when the physical parent exists but is inaccessible
  - `children_count` number: Number of direct child organisations visible to the user
  - `vehicle_count` number: Total number of vehicles in this organisation and its accessible sub-organisations
  - `is_setup` boolean, required: Whether first-time setup is complete for this organisation
  - `path` OrganisationDto[]: Visible ancestor chain from top-level visible ancestor to this organisation

---

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