# Update an organization

**PATCH** `/admin/organizations/{organization_id}`

:::code-group
```bash title="cURL"
curl --request PATCH \
  --url https://api.pinecone.io/admin/organizations/{organization_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "organization-name"
}'
```

```json title="200"
{
  "id": "<string>",
  "name": "<string>",
  "plan": "<string>",
  "payment_status": "<string>",
  "created_at": "<string>",
  "support_tier": "<string>"
}
```
:::

## Authorizations

- `Authorization` (header, string, required) — Bearer authentication header of the form `Bearer <token>`.

## Path Parameters

- `organization_id` (path, string, required) — Organization ID

## Headers

- `X-Pinecone-Api-Version` (header, string, required) — Required date-based version header

## Body

- `name` (body, string) — The new name for the organization.

## Response

- `200` — The organization was successfully updated.
- `400` — Bad request. The request body included invalid request parameters.
- `401` — Unauthorized. Possible causes: Invalid API key.
- `403` — Forbidden
- `404` — Not found
- `500` — Internal server error.
- `4XX` — Unexpected error on request.

## Related pages

- [List organizations](./admin-2-2026-07-admin-organizations-list-organizations.md)
- [Get organization details](./admin-2-2026-07-admin-organizations-get-organization-details.md)
- [Delete an organization](./admin-2-2026-07-admin-organizations-delete-an-organization.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.