Shipment API
โOrganization Management
Endpoint
โ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
circularsub
arrayย ยทย maxItems: 100circularChild 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
circularsub
arrayย ยทย maxItems: 100circularChild 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
circularsub
arrayย ยทย maxItems: 100circularChild organizations (array circular reference)