Services
Who unattended work acts as, and the access profile it is held to
On this page(3 sections)
Automations, sender rules, inbound links and control tokens run as a service: a named identity with a steward and an access profile. A maintainer may write one, since a maintainer writes the automations that run as it, but what a service reaches is never more than its steward may. One still in use cannot be deleted.
GET/access/servicesThe services unattended work runs as
Every service: who it acts for, and the access profile its runs are held to.
What you send
Nothing. Call it as it is.
What comes back
| Field | Type |
|---|---|
servicesEvery service unattended work here may… | object[] |
idThe service's id, what `runAs` names | string |
labelWhat to call it on screen,… | string |
briefWhat it does, in one line | string |
stewardWho it acts for, by email:… | string |
profileThe access profile its runs are… | string |
curl "$SANDBOX/access/services" \
-H "x-intentic-control: $INTENTIC_TOKEN"import { sandbox } from "@intentic/sandbox-client";
const result = await sandbox.services.list();POST/access/servicesCreate or edit a service
Writes the whole service; sending an id that exists edits it. Its steward must be the owner or someone on the roster, and its profile one this sandbox has. Every automation, link and token running as it changes with it from their next turn.
What you send
| Field | Type | Where |
|---|---|---|
idrequiredThe service's id, what `runAs` names | string | body |
labelWhat to call it on screen,… | string | body |
briefWhat it does, in one line | string | body |
stewardrequiredWho it acts for, by email:… | string | body |
profileThe access profile its runs are… | string | body |
What comes back
| Field | Type |
|---|---|
okAlways true | true |
curl -X POST "$SANDBOX/access/services" \
-H "x-intentic-control: $INTENTIC_TOKEN" \
-H "content-type: application/json" \
-d '{"id":"a1b2c3d4","label":"Nightly changelog","brief":"…","steward":"…","profile":"…"}'import { sandbox } from "@intentic/sandbox-client";
const result = await sandbox.services.save({
"id": "a1b2c3d4",
"label": "Nightly changelog",
"brief": "…",
"steward": "…",
"profile": "…"
});DELETE/access/services/{id}Delete a service
Removes the service. Refused while an automation, a sender rule, an inbound link or a control token still runs as it; point them elsewhere first.
What you send
| Field | Type | Where |
|---|---|---|
idrequiredWhich service | string | address |
What comes back
| Field | Type |
|---|---|
okAlways true | true |
curl -X DELETE "$SANDBOX/access/services/a1b2c3d4" \
-H "x-intentic-control: $INTENTIC_TOKEN"import { sandbox } from "@intentic/sandbox-client";
const result = await sandbox.services.remove({
"id": "a1b2c3d4"
});