Download Agent Runner Program
GET/api/automation/runner/download
Download the Agent Runner program (sku-agent-runner.mjs, a single Node.js 20+ file with no dependencies) to the machine that will run it.
Called by your own agent or script with the token SKU issued for this runner or callback, sent as Authorization: Bearer <token> — not with a Personal Access Token or a session.
Authenticate with the runner token as Authorization: Bearer <runner token> (not a Personal Access Token). Unlike the other runner calls, downloading does not mark the runner as seen, so it stays offline until the program starts and sends its first heartbeat.
The response is the file itself (Content-Type: text/javascript, sent as an attachment named sku-agent-runner.mjs), not JSON. Example:
curl -fsSL -H "Authorization: Bearer <runner token>" https://yourcompany.sku.io/api/automation/runner/download -o ~/sku-agent-runner/sku-agent-runner.mjs
Returns 401 for a missing, invalid or revoked token, 421 when the request reached the wrong regional host (retry at redirect_to), 429 above 240 requests a minute per token.
Request
Responses
- 200
- 401
- 403
- 429
OK
Response Headers
Unauthorized
Response Headers
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.