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
| Field | Type |
|---|---|
profilesEvery profile this sandbox grants: its… | object[] |
idThe profile's id, the name a… | string |
labelWhat to call it on screen | string |
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 browser | boolean |
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" |
curl "$SANDBOX/access/profiles" \
-H "x-intentic-control: $INTENTIC_TOKEN"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
| Field | Type | Where |
|---|---|---|
idrequiredThe profile's id, the name a… | string | body |
labelWhat to call it on screen | string | body |
briefWhat this access is for, in… | string | body |
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… | boolean | body |
credentialsThe connected capabilities and stored secrets… | object | body |
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… | object | body |
filesThe most it may do with… | "none" | "read" | "write" | body |
shellFalse takes commands away, and with… | boolean | body |
codeFalse takes away writing and running… | boolean | body |
webFalse takes away fetching a page… | boolean | body |
browserFalse takes away the credential-free browser | boolean | body |
delegateFalse takes away spawning subagents and… | boolean | body |
sandboxFalse takes away changing the sandbox's… | boolean | body |
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
| Field | Type |
|---|---|
ok | true |
holdersThe people whose rows were rewritten,… | object[] |
emailWho holds it, lowercased | string |
tierThe tier the profile makes for… | "guest" | "viewer" | "collaborator" | "writer" |
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"]}'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
| Field | Type | Where |
|---|---|---|
idrequiredWhich profile | string | address |
What comes back
| Field | Type |
|---|---|
okAlways true | true |
curl -X DELETE "$SANDBOX/access/profiles/a1b2c3d4" \
-H "x-intentic-control: $INTENTIC_TOKEN"import { sandbox } from "@intentic/sandbox-client";
const result = await sandbox.accessProfiles.remove({
"id": "a1b2c3d4"
});