---
title: "Update Organization"
method: PUT
path: "/organizations/{organizationId}"
tags: ["Users", "Organizations"]
---

# Update Organization

`PUT /organizations/{organizationId}`

Update specific fields of an existing organization without changing everything.

The `organizationId` in the URL path should be your `externalOrganizationId`. Only the fields you include in your request will be updated—everything else stays the same. Perfect for targeted updates like renaming a company or updating properties.

Prefer a simpler approach? Use `POST /organizations` instead—it automatically creates or updates the organization, so you don't need to know if it exists yet.

## Path parameters

- `organizationId` string, required — Your external organization ID (the externalOrganizationId used when creating the organization)

## Request body

- UpdateOrganizationRequest — Request payload for updating an organization.
  - `name` string — The organization's name.
  - `properties` object — Custom organization properties.

## Response `200`

Organization updated successfully

- UpdateOrganizationResponse — Success response for organization update.
  - `success` boolean, required — Whether the API call was successful.
  - `organization` TenantOrganization, required — The organization that was created or updated.
    - `id` string, required — The Greenflash organization ID.
    - `externalId` string — Your external organization ID.
    - `name` string — The organization name.
    - `properties` object, required — Custom organization properties.
    - `createdAt` string, date-time — When the organization was first created.
    - `updatedAt` string, date-time — When the organization was last updated.

## Other responses

- `404` — Organization not found
- `500` — Server error

## Changes

- **2025-11-24** `c1998d918478` — 2 breaking, 1 warning, 4 info
  - removed the required property `organization/metadata` from the response with the `200` status
  - removed the required property `organization/tenantId` from the response with the `200` status
  - removed the request property `metadata`
  - api tag `Organizations` added
  - …3 more
- **2025-10-09** `48adb6bfe01d` — 2 breaking
  - the `organization/createdAt` response's property type/format changed from `string`/`date` to `string`/`date-time` for status `200`
  - the `organization/updatedAt` response's property type/format changed from `string`/`date` to `string`/`date-time` for status `200`
- **2025-10-09** `e2ce5771d0c3` — 2 breaking
  - the response property `organization/createdAt` became optional for the status `200`
  - the response property `organization/updatedAt` became optional for the status `200`
- **2025-10-06** `8ac2a6f673ac` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/greenflash-ai/apis/greenflash-api-reference/changes/organizations/:organizationId/put.md)

---

[API](https://skmtc.dev/greenflash-ai/apis/greenflash-api-reference.md) · [All operations](https://skmtc.dev/greenflash-ai/apis/greenflash-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/greenflash-ai/greenflash-api-reference/revisions/c566e560677d/schema)