Skip to navigation

Create SSH access for a computer asset

Beta

Generate a time-limited SSH access token for a computer asset. Returns a full SSH command and token that can be used to connect to the computer’s underlying VM and run commands. The computer must support SSH access. If it is stopped, this call starts it first and can take as long as start_computer; after an explicit Stop it returns 409 until you call start_computer. Use get_status to see whether the computer is ready.

Authentication

X-API-KEYstring
API Key authentication via header

Path parameters

asset_idstringRequired

Headers

X-Athena-Session-CredentialstringOptional

Request

This endpoint expects an object.
expires_in_minutesinteger or nullOptional1-1440

How long the SSH access token should remain valid, in minutes (1-1440). The environment may cap this lower (see token_expiry_minutes_options on get_ssh_access); omit it to get the environment’s shortest offered lifetime.

Response

Successful Response
commandstring

Full SSH command to connect to the computer (e.g., ‘ssh token@host’)

expires_in_minutesinteger
Number of minutes until the SSH access token expires
tokenstring
SSH access token used for authentication
proxy_commandstring or nullOptional

Alternative SSH command via proxy (only available for admin users)

token_idstring or nullOptional

Id of the minted token in list_ssh_access_tokens; pass it to revoke_ssh_access_token to revoke it without the raw token.

Errors

401
Unauthorized Error
404
Not Found Error
409
Conflict Error
422
Unprocessable Entity Error
502
Bad Gateway Error