---
title: "Update child organization"
method: PATCH
path: "/v0/organizations/mine/child-organizations/{id}"
tags: ["Organizations"]
---

# Update child organization

`PATCH /v0/organizations/mine/child-organizations/{id}`

## Request

- Base URL: `https://platform.sublime.security`
- URL: `https://platform.sublime.security/v0/organizations/mine/child-organizations/{id}`
- Auth: HTTP bearer

Update a child organization's display name and delegation settings, returning the full child organization.

## Path parameters

- `id` string, uuid, required: ID of the child organization to patch.

## Request body

- PatchChildOrganizationInput
  - `can_add_children` boolean, nullable: Set whether this organization may create its own child organizations. Granting requires the target to be below the maximum hierarchy depth.
  - `can_manage_child_licenses` boolean, nullable: Set whether this organization may manage licenses on its descendants. Granting requires child-organization license management to be enabled for the root organization and the target's immediate parent to already hold this permission; revoking is always allowed.
  - `name` string, nullable: New display name for the organization. Must be non-empty after trimming whitespace.

## Response `200`

OK

- TypesOrganization: The root org
  - `active_automation_rule_count` integer: Number of active automation rules
  - `active_detection_rule_count` integer: Number of active detection rules
  - `active_mailbox_count` integer: Number of currently active mailboxes
  - `can_add_children` boolean, nullable: Whether this organization can add child organizations
  - `can_manage_child_licenses` boolean, nullable: Whether this organization can manage child organization licenses
  - `created_at` string, date-time: Time at which the organization was created
  - `deleted_at` string, date-time, nullable: Time at which org was soft deleted (inaccessible, data not deleted)
  - `id` string: Organization unique ID
  - `licenses` TypesLicense[]: Active licenses for this organization
    - `sku` 'sublime_email_security': Identifies the licensed product. "sublime_email_security" is the only SKU available today.
    - `status` 'trialing' | 'active' | 'no_subscription' | 'past_due' | 'canceled' | 'unpaid' | 'incomplete' | 'incomplete_expired': Current billing status of this license. This reflects the underlying billing state and may differ from a requested transition target. Common values: "trialing" (within a time-limited trial — see trial_expires_at for the end date), "active" (a paid, current subscription), and "no_subscription" (free tier — no active subscription). Stripe-derived states such as "past_due", "canceled", "unpaid", "incomplete", and "incomplete_expired" may also appear.
    - `trial_expires_at` string, date-time, nullable: When the trial period ends. Present only while status is "trialing"; omitted otherwise.
  - `name` string: Organization chosen name
  - `parent_org_id` string, nullable: ID of this organization's parent in the hierarchy. The top-level organization has no parent.
  - `scheduled_for_deletion_at` string, date-time, nullable: Time at which hard deletion of org data is scheduled to begin
  - `total_mailbox_count` integer: Total number of mailboxes

---

[API](https://skmtc.dev/sublime/apis/multi-tenancy-api-beta.md) - [All operations](https://skmtc.dev/sublime/apis/multi-tenancy-api-beta/llms.txt) - [OpenAPI document](https://skmtc.dev/sublime/apis/multi-tenancy-api-beta/revisions/28da41b55c3f?raw)