Extend an active access session
GET/computers/:computerId/extend
Adds time to the active JITA session of the caller (or, for an admin, of the user named by userId).
A session can be extended only during the final 60 minutes before it expires. Earlier, or after expiry, the response is
409 Extend operation must occur within 60 minutes of expiration. t is the number of minutes to add. If t is absent,
not numeric, not greater than 0, or greater than the maximum session duration (default 240 minutes), the default (240 minutes
unless configured otherwise) is used silently; no error is returned for an invalid t. Fractional values are accepted as sent:
t=1.5 adds 1.5 minutes and the message reads Session time extended by 1.5 minutes. t=240 is accepted and t=241 falls back to 240.
Returns 422 No existing access requests found. when the target user has no session in the expiring (active) state; a
pending session does not count. Authorization for acting on behalf of another user is the same as for the access request
(role exactly admin; user and superadmin tokens get 403). Only GET is routed.
Required role: any authenticated user (on-behalf requests need admin).
Request
Responses
- 200
- 401
- 403
- 404
- 409
- 422
Session extended.
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 session is more than 60 minutes from expiring, or has already expired (Extend operation must occur within 60 minutes of expiration.).
The request could not be processed, for example an id that is not a valid object id.