Update an organization
PATCH
/api/organizations/{id}
Updates an organization the user is allowed to edit (EDIT). Only the name can be changed through this endpoint; plan and other subscription fields cannot be modified here. A rename has no side effects.
Authorizations
ApiToken
Long-lived API token created via POST /api/api-tokens (returned once in plaintext).
Type
API Key (header: X-API-TOKEN)
or
JWT
JWT access token obtained via POST /api/auth/login. Send as: Authorization: Bearer
Type
HTTP (bearer)
Parameters
Path Parameters
id*
organization identifier
Type
Requiredstring
Request Body
application/merge-patch+json
JSON "name": "string", "require2fa": true
{
}
Responses
organization resource updated
JSON "@context": "string", "@id": "string", "@type": "string", "id": 42, "name": "Acme GmbH", "plan": "FREE", "trialEndsAt": "2026-07-31T12:00:00+00:00", "scalecommerce": false, "require2fa": false, "createdAt": "2026-07-01T09:30:00+00:00", "updatedAt": "2026-07-01T09:30:00+00:00", "externalCustomerId": "CUST-000123"
{
}