intentic
Download the app
Download the app
The workspace

Access profiles

Named sets of what a holder may reach, shared by people and services

On this page(3 sections)

A profile names the areas, connections, secrets, AI accounts and tools its holders reach, so a team or a service is pointed at one answer rather than given its own copy. A maintainer reads them; both writes are the sandbox owner's, since editing one changes what everybody holding it may do and closes their open connections. A profile anyone or anything still holds cannot be deleted.

GET/access/profilesThe access profiles

Every access profile this sandbox grants, its own and its organisation's: the areas, connections, secrets, AI accounts and tools each lets its holders reach.

What you send

Nothing. Call it as it is.

What comes back

FieldType
profilesEvery profile this sandbox grants: its…object[]
idThe profile's id, the name a…string
labelWhat to call it on screenstring
briefWhat this access is for, in…string
areasThe areas its holders see and…string[]
agentsFor a person: whether their conversations…"off" | "chat" | "run" | "home"
editFor a person: where they change…"all" | string[]
landsFor a home-only person: whether their…boolean
credentialsThe connected capabilities and stored secrets…object
capabilitiesConnected capability ids their conversations may…string[]
secretsStored secret names (not a capability's…string[]
aiAccountsThe AI accounts its holders' turns…string[]
toolsThe most its holders' turns' tools…object
filesThe most it may do with…"none" | "read" | "write"
shellFalse takes commands away, and with…boolean
codeFalse takes away writing and running…boolean
webFalse takes away fetching a page…boolean
browserFalse takes away the credential-free browserboolean
delegateFalse takes away spawning subagents and…boolean
sandboxFalse takes away changing the sandbox's…boolean
extensionsWhich extensions' own agent tools and…string[]
assistantsFor a guest who chats: which…string[]
rolesThe role cards held to it:…string[]
originThe sandbox's own, or the organisation's,…"sandbox" | "org"
Try itanswered in this tab
curl
curl "$SANDBOX/access/profiles" \
  -H "x-intentic-control: $INTENTIC_TOKEN"
TypeScript
import { sandbox } from "@intentic/sandbox-client";

const result = await sandbox.accessProfiles.list();
POST/access/profilesCreate or edit an access profile

Writes the whole profile; sending an id that exists edits it. Everybody holding it changes with it: their roster rows are rewritten and their open connections closed, as a re-grade does. Answers with each person holding it and the tier they now hold.

What you send

FieldTypeWhere
idrequiredThe profile's id, the name a…stringbody
labelWhat to call it on screenstringbody
briefWhat this access is for, in…stringbody
areasThe areas its holders see and…string[]body
agentsFor a person: whether their conversations…"off" | "chat" | "run" | "home"body
editFor a person: where they change…"all" | string[]body
landsFor a home-only person: whether their…booleanbody
credentialsThe connected capabilities and stored secrets…objectbody
capabilitiesrequiredConnected capability ids their conversations may…string[]body
secretsrequiredStored secret names (not a capability's…string[]body
aiAccountsThe AI accounts its holders' turns…string[]body
toolsThe most its holders' turns' tools…objectbody
filesThe most it may do with…"none" | "read" | "write"body
shellFalse takes commands away, and with…booleanbody
codeFalse takes away writing and running…booleanbody
webFalse takes away fetching a page…booleanbody
browserFalse takes away the credential-free browserbooleanbody
delegateFalse takes away spawning subagents and…booleanbody
sandboxFalse takes away changing the sandbox's…booleanbody
extensionsWhich extensions' own agent tools and…string[]body
assistantsFor a guest who chats: which…string[]body
rolesThe role cards held to it:…string[]body

What comes back

FieldType
oktrue
holdersThe people whose rows were rewritten,…object[]
emailWho holds it, lowercasedstring
tierThe tier the profile makes for…"guest" | "viewer" | "collaborator" | "writer"
Try itanswered in this tab
curl
curl -X POST "$SANDBOX/access/profiles" \
  -H "x-intentic-control: $INTENTIC_TOKEN" \
  -H "content-type: application/json" \
  -d '{"id":"a1b2c3d4","label":"Nightly changelog","brief":"…","areas":["…","…"],"agents":"off","edit":"all","lands":true,"credentials":{"capabilities":["…","…"],"secrets":["…","…"]},"aiAccounts":["…","…"],"tools":{"files":"none","shell":true,"code":true,"web":true,"browser":true,"delegate":true,"sandbox":true,"extensions":["ts","md"]},"assistants":["…","…"],"roles":["assistant","assistant"]}'
TypeScript
import { sandbox } from "@intentic/sandbox-client";

const result = await sandbox.accessProfiles.save({
  "id": "a1b2c3d4",
  "label": "Nightly changelog",
  "brief": "…",
  "areas": [
    "…",
    "…"
  ],
  "agents": "off",
  "edit": "all",
  "lands": true,
  "credentials": {
    "capabilities": [
      "…",
      "…"
    ],
    "secrets": [
      "…",
      "…"
    ]
  },
  "aiAccounts": [
    "…",
    "…"
  ],
  "tools": {
    "files": "none",
    "shell": true,
    "code": true,
    "web": true,
    "browser": true,
    "delegate": true,
    "sandbox": true,
    "extensions": [
      "ts",
      "md"
    ]
  },
  "assistants": [
    "…",
    "…"
  ],
  "roles": [
    "assistant",
    "assistant"
  ]
});
DELETE/access/profiles/{id}Delete an access profile

Removes the profile. Refused while a person or a service still holds it; move them onto another profile, or onto answers of their own, first.

What you send

FieldTypeWhere
idrequiredWhich profilestringaddress

What comes back

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

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

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