Skip to main content
POST
/
api
/
asynchronous
/
{siteId}
Queue an asynchronous RouterOS script
curl --request POST \
  --url https://v1.api.altostrat.io/api/asynchronous/{siteId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "description": "Add guest network address",
  "script": "/ip address add address=192.168.99.1/24 interface=bridge",
  "make_backup": true,
  "express_execute": true,
  "needs_acknowledgement": true,
  "notify_url": "https://example.com/sdx/job-complete"
}
'
{
  "status": "success",
  "data": {
    "idempotency_key": "f9e2b0a1-7f12-4d35-9c86-7ebfe33ac18b",
    "request_id": "5f9475ef-565f-5d10-8a86-4c7f5fdb2687",
    "target": "9c69345c-8d39-4786-9f17-8153c988c89a",
    "notify_url": "https://example.com/sdx/job-complete",
    "date": "2026-04-20T03:14:15+00:00"
  }
}

Authorizations

​
Authorization
string
header
required

Authenticate requests by providing a JSON Web Token (JWT) in the Authorization header. Example: Authorization: Bearer <YOUR_JWT>

Path Parameters

​
siteId
string<uuid>
required

The target site/router UUID.

Example:

"9c69345c-8d39-4786-9f17-8153c988c89a"

Body

application/json
​
description
string
required
Example:

"Add guest network address"

​
script
string
required
Example:

"/ip address add address=192.168.99.1/24 interface=bridge"

​
make_backup
boolean
default:false

Create a configuration backup before running the script.

​
express_execute
boolean
default:false

Ask SDX to trigger a faster device check-in where possible.

​
needs_acknowledgement
boolean
default:false

Require the device job to acknowledge completion.

​
notify_url
string<uri> | null

Optional HTTPS callback URL for job status notification.

Example:

"https://example.com/sdx/job-complete"

Response

The script was accepted for asynchronous execution.

​
status
string
Example:

"success"

​
data
object