Skip to main content
POST
/
{site}
/
transient-forward
Create a transient port-forward
curl --request POST \
  --url https://api.altostrat.io/{site}/transient-forward \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "expire_after_minutes": 123,
  "allow_only_cidr": "<string>",
  "dst_address": "127.0.0.1",
  "dst_port": 123
}'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "port": 123,
  "revoked_early": true,
  "allow_only_cidr": "<string>",
  "expires_at": "2023-11-07T05:31:56Z",
  "expired": true,
  "entry_point": "<string>",
  "dst_address": "127.0.0.1",
  "dst_port": 123,
  "time_to_expire": "<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

UUID of the site

Body

application/json

Parameters for the new port-forward

​
expire_after_minutes
number
required

How long until the forward expires (in minutes)

​
allow_only_cidr
string
required

CIDR allowed to connect

​
dst_address
string<ipv4>
required
​
dst_port
number
required

Destination port inside the LAN

Response

Transient port rule created

​
id
string<uuid>
​
port
integer
​
revoked_early
boolean
​
allow_only_cidr
string
​
expires_at
string<date-time>
​
expired
boolean
​
entry_point
string

Hostname or IP address that the user connects to

​
dst_address
string<ipv4>
​
dst_port
integer
​
time_to_expire
string

Human-friendly time difference

⌘I