---
title: "Update current organization"
method: PUT
path: "/v1/identity/org"
tags: ["identity"]
---

# Update current organization

`PUT /v1/identity/org`

## Request body

- OrganizationUpdate
  - `settings` OrgSettings — Typed schema for Organization.settings JSON column.
    - `retry` RetryConfig — Retry configuration — same schema at org, tool, and integration-instance level.
      - `max_retries` integer
      - `base_delay_seconds` number
      - `max_delay_seconds` number
      - `jitter` boolean
    - `kb_role_clearance_map` object, nullable
    - `kb_role_audience_map` object, nullable
    - `kb_classification_mode` 'auto' | 'kb_default', nullable
    - `kb_acl_oversample_factor` integer, nullable

## Response `200`

Successful Response

- OrganizationResponse
  - `id` string, uuid, required
  - `clerk_org_id` string, required
  - `name` string, required
  - `slug` string, nullable, required
  - `plan` string, required
  - `settings` OrgSettings, required — Typed schema for Organization.settings JSON column.
    - `retry` RetryConfig — Retry configuration — same schema at org, tool, and integration-instance level.
      - `max_retries` integer
      - `base_delay_seconds` number
      - `max_delay_seconds` number
      - `jitter` boolean
    - `kb_role_clearance_map` object, nullable
    - `kb_role_audience_map` object, nullable
    - `kb_classification_mode` 'auto' | 'kb_default', nullable
    - `kb_acl_oversample_factor` integer, nullable
  - `is_active` boolean, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `400` — Bad request
- `401` — Authentication required
- `404` — Resource not found
- `422` — Validation Error

---

[API](https://skmtc.net/oneloop-hq/apis/feather-api.md) · [All operations](https://skmtc.net/oneloop-hq/apis/feather-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oneloop-hq/feather-api/versions/888bdd5c076e/schema)