---
title: "Update organization name"
method: PUT
path: "/api/v1/organizations/{id}"
tags: ["Organizations"]
---

# Update organization name

`PUT /api/v1/organizations/{id}`

## Path parameters

- `id` string, uuid, required

## Response `200`

Organization updated

- ApiResponseOrganization
  - `data` object
    - `has_payment_method` boolean
    - `name` string, required
    - `onboarding` OnboardingOperation[], required
    - `plan` union, required
      - object
        - `base_cents` integer, required
        - `host_cents` integer, nullable
        - `included_hosts` integer, nullable
        - `included_networks` integer, nullable
        - `included_seats` integer, nullable
        - `network_cents` integer, nullable
        - `rate` 'Month' | 'Year', required
        - `seat_cents` integer, nullable
        - `trial_days` integer, required
        - `type` 'Community', required
      - object
        - `base_cents` integer, required
        - `host_cents` integer, nullable
        - `included_hosts` integer, nullable
        - `included_networks` integer, nullable
        - `included_seats` integer, nullable
        - `network_cents` integer, nullable
        - `rate` 'Month' | 'Year', required
        - `seat_cents` integer, nullable
        - `trial_days` integer, required
        - `type` 'Free', required
      - object
        - `base_cents` integer, required
        - `host_cents` integer, nullable
        - `included_hosts` integer, nullable
        - `included_networks` integer, nullable
        - `included_seats` integer, nullable
        - `network_cents` integer, nullable
        - `rate` 'Month' | 'Year', required
        - `seat_cents` integer, nullable
        - `trial_days` integer, required
        - `type` 'Starter', required
      - object
        - `base_cents` integer, required
        - `host_cents` integer, nullable
        - `included_hosts` integer, nullable
        - `included_networks` integer, nullable
        - `included_seats` integer, nullable
        - `network_cents` integer, nullable
        - `rate` 'Month' | 'Year', required
        - `seat_cents` integer, nullable
        - `trial_days` integer, required
        - `type` 'Pro', required
      - object
        - `base_cents` integer, required
        - `host_cents` integer, nullable
        - `included_hosts` integer, nullable
        - `included_networks` integer, nullable
        - `included_seats` integer, nullable
        - `network_cents` integer, nullable
        - `rate` 'Month' | 'Year', required
        - `seat_cents` integer, nullable
        - `trial_days` integer, required
        - `type` 'Team', required
      - object
        - `base_cents` integer, required
        - `host_cents` integer, nullable
        - `included_hosts` integer, nullable
        - `included_networks` integer, nullable
        - `included_seats` integer, nullable
        - `network_cents` integer, nullable
        - `rate` 'Month' | 'Year', required
        - `seat_cents` integer, nullable
        - `trial_days` integer, required
        - `type` 'Business', required
      - object
        - `base_cents` integer, required
        - `host_cents` integer, nullable
        - `included_hosts` integer, nullable
        - `included_networks` integer, nullable
        - `included_seats` integer, nullable
        - `network_cents` integer, nullable
        - `rate` 'Month' | 'Year', required
        - `seat_cents` integer, nullable
        - `trial_days` integer, required
        - `type` 'Enterprise', required
      - object
        - `base_cents` integer, required
        - `host_cents` integer, nullable
        - `included_hosts` integer, nullable
        - `included_networks` integer, nullable
        - `included_seats` integer, nullable
        - `network_cents` integer, nullable
        - `rate` 'Month' | 'Year', required
        - `seat_cents` integer, nullable
        - `trial_days` integer, required
        - `type` 'Demo', required
      - object
        - `base_cents` integer, required
        - `host_cents` integer, nullable
        - `included_hosts` integer, nullable
        - `included_networks` integer, nullable
        - `included_seats` integer, nullable
        - `network_cents` integer, nullable
        - `rate` 'Month' | 'Year', required
        - `seat_cents` integer, nullable
        - `trial_days` integer, required
        - `type` 'CommercialSelfHosted', required
    - `plan_status` string, nullable, required
    - `trial_end_date` string, date-time, nullable
    - `use_case` 'homelab' | 'internal_it' | 'msp' | 'other'
    - `created_at` string, date-time, required
    - `id` string, uuid, required
    - `updated_at` string, date-time, required
  - `error` string, nullable
  - `meta` ApiMeta, required — API metadata included in all responses
    - `api_version` integer, required — API version (integer, increments on breaking changes)
    - `server_version` string, required — Server version (semver)
  - `success` boolean, required

## Other responses

- `403` — Only owners can update organization
- `404` — Organization not found

## Changes

- **2026-04-20** `f04499e2280f` — 3 breaking, 8 warning, 6 info
  - the response property `data/allOf[#/components/schemas/OrganizationBase]/plan_status` became nullable for the status `200`
  - added `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6, subschema #7, subschema #8, subschema #9` to the `data/allOf[#/components/schemas/OrganizationBase]/plan/oneOf[#/components/schemas/BillingPlan]/` response property `oneOf` list for the response status `200`
  - the `data/allOf[#/components/schemas/OrganizationBase]/plan_status` response's property type/format changed from ``/`` to `string, null`/`` for status `200`
  - removed the optional property `data/allOf[#/components/schemas/OrganizationBase]/discount_save_offer_active_until` from the response with the `200` status
  - …13 more

[Change history](https://skmtc.dev/scanopy/apis/scanopy-api/changes/api/v1/organizations/:id/put.md)

---

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