Skip to main content
POST
/
{site}
/
transient-accesses
Create a transient access for a site
curl --request POST \
  --url https://api.altostrat.io/{site}/transient-accesses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "expire_after_minutes": 123,
  "type": "winbox",
  "full_access": true,
  "access_type": "read",
  "allow_rfc1918": true,
  "allow_only_cidr": "<string>"
}'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "username": "<string>",
  "password": "<string>",
  "port": 123,
  "type": "<string>",
  "full_access": true,
  "access_type": "<string>",
  "allow_rfc1918": true,
  "expires_at": "2023-11-07T05:31:56Z",
  "expired": true,
  "revoked_early": true,
  "entry_point": "<string>",
  "time_to_expire": "<string>",
  "onclick": "<string>"
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

site
string<uuid>
required

The site UUID

Body

application/json

Transient access fields (type, expire time, etc.)

expire_after_minutes
number
required

How long until the access expires

type
enum<string>
required
Available options:
winbox,
ssh
full_access
boolean
required
allow_rfc1918
boolean
required
allow_only_cidr
string
required

CIDR notation allowed to connect

access_type
enum<string> | null
Available options:
read,
write,
full

Response

Transient access created

id
string<uuid>
username
string
password
string
port
integer
type
string
full_access
boolean
access_type
string | null
allow_rfc1918
boolean
expires_at
string<date-time>
expired
boolean
revoked_early
boolean
entry_point
string

Hostname or IP address used to connect

time_to_expire
string

Human-friendly time difference

onclick
string

winbox://... link if relevant

I