---
title: "Rename an organization."
method: PATCH
path: "/v1/org"
tags: ["org"]
---

# Rename an organization.

`PATCH /v1/org`

## Request

- Base URL: `https://api.smolmachines.com`
- URL: `https://api.smolmachines.com/v1/org`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/smolmachines/apis/smolfleet-api/docs/v1/org/patch.ts> (a function with typed inputs; its response is checked against the schema)

Changes the organization's display name. Requires a user login, not an API key, and the `members:write` scope (owner or admin).

## Request body

- RenameOrgRequest: `PATCH /v1/org` renames the organization; the slug is final so only the name changes.
  - `displayName` string, required: The new display name, trimmed, 1 to 100 characters, same bound as at creation.

## Response `200`

Renamed; only the display label changes, since the slug is final, and the body reads as GET /v1/org does without the counts.

- OrgSummary: Summary of the caller's org context driving the console's member UI.
  - `canManageMembers` boolean, required: True when the caller may invite/change-role/remove members (owner/admin).
  - `displayName` string, nullable: The display name the owner may rename; null when the account is not an organization.
  - `isOrganization` boolean, required: True when the account is an organization (vs an individual login).
  - `name` string, nullable: The slug, unique and final once chosen; null when the account is not an organization.
  - `quota` OrgQuota: An organization's limits and usage, counted once across every member's machines.
    - `machines` integer, required: How many machines it has now, by the same count the refusal reports.
    - `running` integer, required: How many are running now, by the concurrency cap's own predicate.
  - `tenantId` string, nullable: The org's tenant id for `Smol-Tenant`; null when the account is not an organization.

## Other responses

- `400`: A display name outside 1 to 100 characters after trimming
- `401`: Missing or invalid API key
- `403`: Renaming an organization is an owner or admin action, or the caller is an API key
- `422`: An individual account, not an organization
- `429`: Rate limited; retry after the Retry-After header
- `500`: Internal error

## Changes

- **2026-10-16** `bc31fc04a568`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/smolmachines/apis/smolfleet-api/changes/v1/org/patch.md)

---

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