BusinessUnits
Business units are used for advanced access policies where users have different permissions on different entities in the system depending on the business units they are part of and how these business units are related to the entities.
Authorizations
Responses
200
OK
get
GET /v1/businessunits HTTP/1.1
Host:
Authorization: YOUR_API_KEY
Accept: */*
200
OK
[
{
"Uid": "123e4567-e89b-12d3-a456-426614174000",
"Alias": "text",
"Name": "text",
"Created": "2025-06-27T08:46:56.026Z",
"CreatedBy": "text",
"LastModified": "2025-06-27T08:46:56.026Z",
"LastModifiedBy": "text"
}
]
Authorizations
Body
Model for creating a business unit
Uidstring · uuidOptional
Unique identifier of the business unit
Aliasstring | nullableOptional
Alias of the business unit
Namestring | nullableOptional
Name of the business unit
Responses
200
OK
post
POST /v1/businessunits HTTP/1.1
Host:
Authorization: YOUR_API_KEY
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 75
{
"Uid": "123e4567-e89b-12d3-a456-426614174000",
"Alias": "text",
"Name": "text"
}
200
OK
No content
Authorizations
Body
Model for updating a business unit
Uidstring · uuidOptional
Unique identifier of the business unit
Aliasstring | nullableOptional
Alias of the business unit
Namestring | nullableOptional
Name of the business unit
Responses
200
OK
put
PUT /v1/businessunits HTTP/1.1
Host:
Authorization: YOUR_API_KEY
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 75
{
"Uid": "123e4567-e89b-12d3-a456-426614174000",
"Alias": "text",
"Name": "text"
}
200
OK
No content
Authorizations
Path parameters
uidstring · uuidRequired
Responses
200
OK
404
Not Found
get
GET /v1/businessunits/{uid} HTTP/1.1
Host:
Authorization: YOUR_API_KEY
Accept: */*
{
"Uid": "123e4567-e89b-12d3-a456-426614174000",
"Alias": "text",
"Name": "text",
"Created": "2025-06-27T08:46:56.026Z",
"CreatedBy": "text",
"LastModified": "2025-06-27T08:46:56.026Z",
"LastModifiedBy": "text"
}