List all organizations
GET
https://api.sh.example.com/v1
/organizations
Returns a list of all organizations in the hierarchy
Responses
id
string · pattern:^[a-zA-Z0-9-]+$
· requiredUnique identifier for the organization
name
string · minLength: 1 · maxLength: 200 · requiredName of the organization
parent
circular
sub
array · maxItems: 100 ·circular
Child organizations (array circular reference)
Create a new organization
POST
https://api.sh.example.com/v1
/organizations
Creates a new organization, optionally as part of an existing hierarchy
Request Body
id
string · pattern:^[a-zA-Z0-9-]+$
· requiredUnique identifier for the organization
name
string · minLength: 1 · maxLength: 200 · requiredName of the organization
parent
circular
sub
array · maxItems: 100 ·circular
Child organizations (array circular reference)
Responses
id
string · pattern:^[a-zA-Z0-9-]+$
· requiredUnique identifier for the organization
name
string · minLength: 1 · maxLength: 200 · requiredName of the organization
parent
circular
sub
array · maxItems: 100 ·circular
Child organizations (array circular reference)