---
title: "Update an Organization"
method: PATCH
path: "/v1/organizations/{organizationId}"
tags: ["organizations"]
---

# Update an Organization

`PATCH /v1/organizations/{organizationId}`

## Request

- Base URL: `https://api.vercel.com`
- URL: `https://api.vercel.com/v1/organizations/{organizationId}`
- Auth: HTTP bearer

Update an organization's slug, name, or avatar. Upload avatar images through the existing files API before setting their hash. The organization avatar is independent of the root team's avatar. This endpoint is in private beta. Contact your Vercel account team for access.

## Path parameters

- `organizationId` string, required: The ID of the organization to update.

## Request body

- object
  - `avatar` string, nullable: The hash value of an uploaded image, or `null` to clear the organization avatar. Omit to leave it unchanged.
  - `name` string: The new display name for the organization.
  - `slug` string: The new slug for the organization.

## Response `200`

- Organization
  - `avatar` string, nullable, required
  - `createdAt` string, required
  - `name` string: The organization's display name. Optional: organizations created before the name attribute existed have no stored value. New orgs always get one (provided or slug-derived) via the service layer.
  - `organizationId` string, required
  - `slug` string, required
  - `teamCount` number, required
  - `teamId` string, required
  - `updatedAt` string, required
  - `userRole` string: The authenticated user's role in the organization. Present on read endpoints when the user holds an organization role.

## Other responses

- `400`: One of the provided values in the request body is invalid. One of the provided values in the request query is invalid.
- `401`: The request is not authorized.
- `403`: You do not have permission to access this resource.
- `404`
- `409`
- `410`

## Changes

- **2026-10-20** `e78cd78343b7`: 1 breaking
  - removed the required property `ownerId` from the response with the `200` status
- **2026-10-16** `0dc5069cda5a`: 1 info
  - added the new optional request property `name`
- **2026-10-16** `0e48cb239c6a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/vercel/apis/api/changes/v1/organizations/:organizationId/patch.md)

---

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