Run targets
The programs each repository declares, run on one of your own computers
A repository can declare programs that run on the owner's own machines rather than in the sandbox. One read lists what each repository declares and which of your computers could run one now; the other builds a target here, carries the build over and starts it there, in a terminal you can watch. The computer still decides whether it accepts programs this sandbox sends.
GET/runs/targetsWhat each repository can run on your computers
Every repository that declares run targets at `.intentic/run.json`, and which of your computers could run one now.
What you send
Nothing. Call it as it is.
What comes back
| Field | Type |
|---|---|
repos | object[] |
repo | string |
path | string |
targets | object[] |
name | string |
description | string |
device | string |
build | string |
artifact | string | object |
program | string |
args | string[] |
env | object |
isolated | boolean |
reach | integer[] |
error | string |
devices | object[] |
id | string |
online | boolean |
programs | boolean |
allowed | boolean |
curl "$SANDBOX/runs/targets" \
-H "x-intentic-control: $INTENTIC_TOKEN"import { sandbox } from "@intentic/sandbox-client";
const result = await sandbox.runs.targets();POST/runs/startRun a target on one of your computers
Builds it in the sandbox, carries the build to the computer and starts it there, in a terminal you can watch. The computer still decides: its "Run programs this sandbox sends" switch has to be on.
What you send
| Field | Type | Where |
|---|---|---|
reporequired | string | body |
targetrequired | string | body |
devicerequired | string | body |
What comes back
| Field | Type |
|---|---|
session | string |
curl -X POST "$SANDBOX/runs/start" \
-H "x-intentic-control: $INTENTIC_TOKEN" \
-H "content-type: application/json" \
-d '{"repo":"root","target":"…","device":"…"}'import { sandbox } from "@intentic/sandbox-client";
const result = await sandbox.runs.start({
"repo": "root",
"target": "…",
"device": "…"
});