---
title: "Change an organisation"
description: "Set your team's Studio name, shown at the top of the Studio without changing any suite login page, and the models your assistant offers in the Studio."
canonical: "https://grid82.com/docs/builder-api/orgs/update"
updated: "2026-11-13"
---

# Change an organisation

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

Set your team's Studio name, shown at the top of the Studio without changing any suite login page, and the models your assistant offers in the Studio.

This menu applies only to the Studio; set app users' options per suite, where they see a label rather than a model name.

Requires the `schema:write` scope. Operation `orgs.update`. MCP tool `orgs_update`. CLI: `grid82 orgs update` (`npx grid82`).

## 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 60 characters. |
| `assistantModels` | object\[] | no       | 1 to 5 items.        |

**Authorizations**

- `Authorization` (bearer, in header, required)

## Response

**200**: Success

- `data` (`object`, required)
- `data.id` (`string`, required)
- `data.name` (`string`, required)
- `data.assistantModels` (`object[]`, required)
- `data.assistantModels.label` (`string`, required, length: `1–24 chars`)
- `data.assistantModels.model` (`string`, required, length: `1–120 chars`)
- `data.assistantModels.reasoning` (`enum<string> | null`, required)

```json
{
  "data": {
    "id": "<string>",
    "name": "<string>",
    "assistantModels": [
      {
        "label": "<string>",
        "model": "<string>",
        "reasoning": "none"
      }
    ]
  }
}
```

**4XX**: Refused

- `error` (`object`, required)
- `error.code` (`enum<string>`, required, one of: `not_found, forbidden, unauthenticated, validation_failed, conflict, rate_limited, payment_required, not_implemented, internal`)
- `error.message` (`string`, required)
- `error.details` (`Record<string, unknown>`)

```json
{
  "error": {
    "code": "not_found",
    "message": "<string>",
    "details": {}
  }
}
```

**Example request**

```bash
curl --request PATCH \
  --url 'https://studio.grid82.app/v1/organizations/<organizationId>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<string>",
  "assistantModels": [
    {
      "label": "<string>",
      "model": "<string>",
      "reasoning": "none"
    }
  ]
}'
```