Bulk update child organization licensing

post

{scheme}://{server}/v0/organizations/mine/child-organizations/bulk-licensing

Apply license transitions to up to 200 child organizations in one call. Each organization is evaluated independently; per-organization failures are reported in the results array, not the HTTP status.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

items

array of objects

required

length between 1 and 200

Per-organization transitions to apply. Capped at 200 entries per call. The same org_id may not appear more than once. The caller must be able to manage licenses on every listed organization, or the entire request is rejected before any transition is attempted.

items*

licenses

array of objects

required

length between 1 and 1

License transition to apply to this organization. Exactly one license per entry is supported today; the array shape is reserved for future multi-SKU support.

licenses*

sku

string

enum

required

Identifies the product to license. "sublime_email_security" is the only SKU available today.

Allowed:

status

string

required

Desired billing state for the license. Valid values: "trialing", "active", "canceled". Use "canceled" to downgrade an existing license back to free.

trial_days

int32 | null

1 to 90

Length of the trial in days (only used when status is trialing.) If not set, the default trial length will be used.

org_id

uuid

required

ID of the child organization this entry targets. Must be a descendant of the calling organization.

200OK