intentic
Download the app
Download the app
The workspace

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

FieldType
servicesEvery service unattended work here may…object[]
idThe service's id, what `runAs` namesstring
labelWhat to call it on screen,…string
briefWhat it does, in one linestring
stewardWho it acts for, by email:…string
profileThe access profile its runs are…string
Try itanswered in this tab
curl
curl "$SANDBOX/access/services" \
  -H "x-intentic-control: $INTENTIC_TOKEN"
TypeScript
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

FieldTypeWhere
idrequiredThe service's id, what `runAs` namesstringbody
labelWhat to call it on screen,…stringbody
briefWhat it does, in one linestringbody
stewardrequiredWho it acts for, by email:…stringbody
profileThe access profile its runs are…stringbody

What comes back

FieldType
okAlways truetrue
Try itanswered in this tab
curl
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":"…"}'
TypeScript
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

FieldTypeWhere
idrequiredWhich servicestringaddress

What comes back

FieldType
okAlways truetrue
Try itanswered in this tab
curl
curl -X DELETE "$SANDBOX/access/services/a1b2c3d4" \
  -H "x-intentic-control: $INTENTIC_TOKEN"
TypeScript
import { sandbox } from "@intentic/sandbox-client";

const result = await sandbox.services.remove({
  "id": "a1b2c3d4"
});

Type to search every page, in the docs and the API reference.