Create a Sub-Org

{
  "name": "PrimeVault customer"
}

# Sample only. Generate a new signed token for each request
# (see Authentication). Tokens expire after 120 seconds.
curl --request POST \
  --url "https://api.primevault.com/api/external/sub_orgs/" \
  --header "Authorization: Bearer <signed JWT>" \
  --header "Api-Key: <API key>" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "PrimeVault customer"
  }'

const subOrg = await apiClient.createSubOrg({
  name: "PrimeVault customer",
});
console.log(subOrg.id, subOrg.controlMode);

from primevault_python_sdk.types import CreateSubOrgRequest

sub_org = api_client.create_sub_org(
    CreateSubOrgRequest(name="PrimeVault customer")
)
print(sub_org.id, sub_org.controlMode)

{
  "id": "a648fa0d-4ca9-4f4f-a520-7ef5e9db34eb",
  "orgId": "a30d5e99-7076-45da-a933-0d5642619340",
  "name": "PrimeVault customer",
  "controlMode": "MANAGED",
  "createdAt": "2026-09-14T12:00:00Z",
  "updatedAt": "2026-09-14T12:00:00Z",
  "isDeleted": false,
  "version": 1
}

interface SubOrg {
  id: string;
  orgId: string;
  name: string;
  controlMode: SubOrgControlMode | null;
  createdAt: string;
  updatedAt: string;
  isDeleted: boolean;
  version: number;
}