Get Unit
GET
/units/{unitId}
Retrieves a single Unit by ID, including resource and action counts. Scoped to the current Space — returns 404 if the Unit does not exist or belongs to a different Space.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ” unitId
required
string
Header Parameters
Section titled “Header Parameters ” X-Space-Id
required
string format: uuid
UUID of the target Space (tenant boundary). Validated against user access.
Responses
Section titled “ Responses ”object
id
required
Unit ID
string format: uuid
Example
550e8400-e29b-41d4-a716-446655440000 spaceId
required
Space ID
string format: uuid
Example
660e8400-e29b-41d4-a716-446655440000 name
required
Unit name
string
Example
Production Department resourceCount
required
Number of resources assigned to this unit
number
Example
12 actionCount
required
Number of actions assigned to this unit
number
Example
5Unauthorized — missing or invalid JWT
Forbidden — insufficient permissions
Resource not found