List the administrators in a computer's inventory
GET/computers/:computerId/admins
Returns the accounts in the computer's admin inventory, merged with accounts that currently hold an active
JITA session (flagged active: true with expiring set; accessViaGroup is the group document when access came through a group). Active sessions for accounts not in the inventory
are appended as additional entries with persistent: false; those entries carry only domain, domainandname, sidusage, user,
svc_acct, sid, onHost, active, session_initiated, expiring, userId and persistent. The list is a bare array and is not paged: limit and page are ignored.
The route is open to all roles, but a caller whose role is user must be a system administrator of the
computer (direct entry or via a group); otherwise 403. A user-role caller who is a system administrator sees the whole list.
Required role: superadmin or admin; user only if a system administrator of this computer.
Request
Responses
- 200
- 401
- 403
- 404
- 422
Administrators of the computer.
No token, or the token is invalid or expired. The body is {message}: No auth token provided when no token is sent, otherwise the token check's message (jwt expired, jwt malformed, invalid signature, invalid token, jwt signature is required). Send Authorization: Bearer <token> exactly: the server drops the first seven characters of the header and reads the rest as the token, so a different scheme or an extra space fails. If Authorization is absent, the server reads a token field in the body, then a token query parameter, then x-access-token. Routes that validate query fields reject ?token= with 400 InvalidQuery.
The token's role is not allowed for this operation, or the token's scopes exclude the route
(Scope not allowed by token).
No record has the :id in the path (the id is malformed or unknown). The body is the bare text Invalid <Type> ID (for example Invalid Computer ID, Invalid User ID) with Content-Type text/html; charset=utf-8, not JSON. Some routes return an empty body.
The request could not be processed, for example an id that is not a valid object id.