---
title: "Change an organisation"
description: "Its name, what your team sees at the top of the Studio, never touching any suite's login page, and the models your own assistant offers here."
canonical: "https://gtable.app/docs/builder-api/orgs/update"
updated: "2026-10-05"
---

# Change an organisation

`PATCH https://studio.gtable.app/v1/organizations/{organizationId}`

Its name, what your team sees at the top of the Studio, never touching any suite's login page, and the models your own assistant offers here.

That menu is the Studio's alone: what the users in your apps are offered is set per suite, and they see a label rather than a model name.

Requires the `schema:write` scope. Operation `orgs.update`. MCP tool `orgs_update`. CLI, once published: `gtable orgs update`.

## Path parameters

| Name             | Type   | Required | Description |
| ---------------- | ------ | -------- | ----------- |
| `organizationId` | string | yes      |             |

## Headers

| Name              | Type   | Required | Description                                                                                                                                                                                                                                                        |
| ----------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Idempotency-Key` | string | no       | Any unique string. Sending the same key with the same request again returns the first response (marked `Idempotency-Replayed: true`) instead of running it twice. Reusing it for a different request is refused with 409. Kept for 24 hours. Up to 255 characters. |

## Request body

| Field             | Type      | Required | Description           |
| ----------------- | --------- | -------- | --------------------- |
| `name`            | string    | no       | Up to 120 characters. |
| `assistantModels` | object\[] | no       | 1 to 5 items.         |