---
title: "Update Organization Endpoint"
method: PATCH
path: "/api/me/organizations/{tenant_id}"
tags: ["me"]
---

# Update Organization Endpoint

`PATCH /api/me/organizations/{tenant_id}`

## Request

- Base URL: `https://app.thinqos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.thinqos.com/api/me/organizations/{tenant_id}`
- Auth: none declared

Rename this organization, or list it in the directory. Owner or admin only.

Turning Discoverable on is what lets somebody who does not already know
this organization exists ask to join it. Turning it off stops new requests
without touching the people already here or the requests already waiting,
because withdrawing an invitation is not the same act as removing a
colleague.

## Path parameters

- `tenant_id` string, uuid, required

## Headers

- `x-impersonate-identity-id` string, nullable

## Request body

- UpdateOrganizationIn: Rename an organization, or list it in the directory (TOS-4113 Lane A).
  - `display_name` string, nullable
  - `discoverable` boolean, nullable

## Response `200`

Successful Response

- OrganizationDetailOut: Everything the organization page renders (TOS-4113).
  - `tenant_id` string, uuid, required
  - `display_name` string, required
  - `slug` string, required
  - `logo_url` string, nullable, required
  - `my_role` string, required
  - `can_manage` boolean, required
  - `can_manage_owners` boolean, required
  - `discoverable` boolean, required
  - `members` OrganizationSeatOut[], required
    - `identity_id` string, uuid, required
    - `display_name` string, required
    - `email` string, nullable, required
    - `role` string, required
    - `source` string, required
    - `granted_by` string, uuid, nullable, required
    - `is_agent` boolean, required
  - `join_rules` OrganizationJoinRuleOut[], required
    - `id` string, uuid, required
    - `kind` string, required
    - `value` string, required
    - `default_role` string, required
  - `pending_join_requests` OrganizationJoinRequestOut[], required
    - `id` string, uuid, required
    - `tenant_id` string, uuid, required
    - `identity_id` string, uuid, required
    - `display_name` string, required
    - `email` string, nullable, required
    - `status` string, required
    - `message` string, nullable, required
    - `created_at` string, date-time, required
    - `decided_at` string, date-time, nullable, required
  - `conversation_status` OrganizationConversationStatusOut, required
    - `state` 'ready' | 'mindset_required' | 'confirmation_required' | 'funding_required', required
    - `blocking_reasons` string[], required
    - `can_configure` boolean, required

## Other responses

- `422`: Validation Error

---

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