intentic
Download the app
Download the app
Models and accounts

Connections hub

Connections kept on the owner's computer, saved from one sandbox and taken into another

On this page(3 sections)

Lists the owner's computers whose keyring can hold connections and every card and model account held here with whether it can go there; saves one to a computer's keyring; and asks the computers for a saved one to use here. Only credentials that do not rotate travel: CLI connector cards, tool servers, model endpoints and static model keys. The person at the computer says yes to every save and every share, and no credential is returned by these routes.

GET/hubConnections on your computer, and which held here can go there

The owner's computers whose keyring can hold connections; every card and model account held here, whether it can go to the hub and why not, which were saved there from here and which were made here from it; and any entry shared here that could not be made into a connection. No credential is in the answer.

What you send

Nothing. Call it as it is.

What comes back

FieldType
computersobject[]
machinestring
onlineboolean
setUpIts keyring is installed and set…boolean
lockedboolean
holdingsobject[]
targetobject
when type is "card"shape
idstring
when type is "account"shape
provider"cursor" | "devin" | "zai" | "meta"
idstring
labelstring
wantWhat another sandbox asks with to…object
when type is "card"shape
kind"cli" | "mcp" | "endpoint"
connectorstring
when type is "account"shape
provider"cursor" | "devin" | "zai" | "meta"
reasonWhy it cannot go to the…string
savedIt was saved to the hub…object
entrystring
machinestring
atnumber
pendingIt waits for a yes at…boolean
fromIt was made here from a…object
entrystring
machinestring
failuresobject[]
entrystring
machinestring
messagestring
atnumber
Try itanswered in this tab
curl
curl "$SANDBOX/hub" \
  -H "x-intentic-control: $INTENTIC_TOKEN"
TypeScript
import { sandbox } from "@intentic/sandbox-client";

const result = await sandbox.hub.state();
POST/hub/saveSave a connection to your computer

Sends one card or static model account to the named computer's keyring, sealed to it, to keep as a hub entry shared back here. The person at the computer says yes first; a locked keyring holds it until the next unlock. Saving the same connection again replaces that entry, so every sandbox using it gets the new value.

What you send

FieldTypeWhere
targetrequiredobjectbody
when type is "card"shapebody
idrequiredstringbody
when type is "account"shapebody
providerrequired"cursor" | "devin" | "zai" | "meta"body
idrequiredstringbody
machinerequiredstringbody

What comes back

FieldType
entrystring
machinestring
pendingIt waits for the next unlock…boolean
Try itanswered in this tab
curl
curl -X POST "$SANDBOX/hub/save" \
  -H "x-intentic-control: $INTENTIC_TOKEN" \
  -H "content-type: application/json" \
  -d '{"target":{"type":"card","id":"a1b2c3d4"},"machine":"…"}'
TypeScript
import { sandbox } from "@intentic/sandbox-client";

const result = await sandbox.hub.save({
  "target": {
    "type": "card",
    "id": "a1b2c3d4"
  },
  "machine": "…"
});
POST/hub/takeUse a connection saved on your computer

Asks the owner's computers for a saved connection of this kind. The keyring offers the person what matches and shares the one they pick here; it is then made into a card or account here and follows that entry from then on.

What you send

FieldTypeWhere
wantrequiredobjectbody
when type is "card"shapebody
kindrequired"cli" | "mcp" | "endpoint"body
connectorstringbody
when type is "account"shapebody
providerrequired"cursor" | "devin" | "zai" | "meta"body
whystringbody

What comes back

FieldType
outcomeShared and made here; waiting for…"taken" | "waiting" | "none"
messagestring
targetWhat it was made into here,…object
when type is "card"shape
idstring
when type is "account"shape
provider"cursor" | "devin" | "zai" | "meta"
idstring
Try itanswered in this tab
curl
curl -X POST "$SANDBOX/hub/take" \
  -H "x-intentic-control: $INTENTIC_TOKEN" \
  -H "content-type: application/json" \
  -d '{"want":{"type":"card","kind":"cli","connector":"…"},"why":"…"}'
TypeScript
import { sandbox } from "@intentic/sandbox-client";

const result = await sandbox.hub.take({
  "want": {
    "type": "card",
    "kind": "cli",
    "connector": "…"
  },
  "why": "…"
});

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