List Units
GET
/units
Returns a paginated list of Units in the current Space. Supports search by name and sorting by name, resourceCount, or actionCount. Each item includes the count of assigned Resources and Actions.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Query Parameters
Section titled “Query Parameters ” page
number
Example
1Page number (1-based)
limit
number
Example
20Items per page (max 100)
sortDir
string
Example
ascSort direction
search
string
Example
productionSearch by name (case-insensitive)
sortBy
string
Example
nameSort field
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
data
required
Array<object>
object
id
required
Unit ID
string format: uuid
Example
550e8400-e29b-41d4-a716-446655440000 name
required
Unit name
string
Example
Production Department resourceCount
required
Number of assigned resources
number
Example
12 actionCount
required
Number of assigned actions
number
Example
5 meta
required
object
page
required
Current page number
number
Example
1 limit
required
Items per page
number
Example
20 total
required
Total number of items
number
Example
42 totalPages
required
Total number of pages
number
Example
3Unauthorized — missing or invalid JWT
Forbidden — insufficient permissions