---
title: "Connections hub · intentic sandbox API"
description: "Connections kept on the owner's computer, saved from one sandbox and taken into another. Every route in the connections hub group of the intentic sandbox API."
url: "https://intentic.dev/api/hub/"
---

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)**

- [Connections on your computer, and which held here can go there](#hub-state)
- [Save a connection to your computer](#hub-save)
- [Use a connection saved on your computer](#hub-take)

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`/hub` Connections 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

| Field | Type |
| --- | --- |
| `computers` | object[] |
| `machine` | string |
| `online` | boolean |
| `setUp` Its keyring is installed and set… | boolean |
| `locked` | boolean |
| `holdings` | object[] |
| `target` | object |
| `when type is "card"` | shape |
| `id` | string |
| `when type is "account"` | shape |
| `provider` | "cursor" | "devin" | "zai" | "meta" |
| `id` | string |
| `label` | string |
| `want` What another sandbox asks with to… | object |
| `when type is "card"` | shape |
| `kind` | "cli" | "mcp" | "endpoint" |
| `connector` | string |
| `when type is "account"` | shape |
| `provider` | "cursor" | "devin" | "zai" | "meta" |
| `reason` Why it cannot go to the… | string |
| `saved` It was saved to the hub… | object |
| `entry` | string |
| `machine` | string |
| `at` | number |
| `pending` It waits for a yes at… | boolean |
| `from` It was made here from a… | object |
| `entry` | string |
| `machine` | string |
| `failures` | object[] |
| `entry` | string |
| `machine` | string |
| `message` | string |
| `at` | number |

Try it answered in this tab

curl

```bash
curl "$SANDBOX/hub" \
 -H "x-intentic-control: $INTENTIC_TOKEN"
```

TypeScript

```typescript
import { sandbox } from "@intentic/sandbox-client";

const result = await sandbox.hub.state();
```

**POST`/hub/save` Save 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

| Field | Type | Where |
| --- | --- | --- |
| `target` required | object | body |
| `when type is "card"` | shape | body |
| `id` required | string | body |
| `when type is "account"` | shape | body |
| `provider` required | "cursor" | "devin" | "zai" | "meta" | body |
| `id` required | string | body |
| `machine` required | string | body |

### What comes back

| Field | Type |
| --- | --- |
| `entry` | string |
| `machine` | string |
| `pending` It waits for the next unlock… | boolean |

Try it answered in this tab

curl

```bash
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

```typescript
import { sandbox } from "@intentic/sandbox-client";

const result = await sandbox.hub.save({
 "target": {
 "type": "card",
 "id": "a1b2c3d4"
 },
 "machine": "…"
});
```

**POST`/hub/take` Use 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

| Field | Type | Where |
| --- | --- | --- |
| `want` required | object | body |
| `when type is "card"` | shape | body |
| `kind` required | "cli" | "mcp" | "endpoint" | body |
| `connector` | string | body |
| `when type is "account"` | shape | body |
| `provider` required | "cursor" | "devin" | "zai" | "meta" | body |
| `why` | string | body |

### What comes back

| Field | Type |
| --- | --- |
| `outcome` Shared and made here; waiting for… | "taken" | "waiting" | "none" |
| `message` | string |
| `target` What it was made into here,… | object |
| `when type is "card"` | shape |
| `id` | string |
| `when type is "account"` | shape |
| `provider` | "cursor" | "devin" | "zai" | "meta" |
| `id` | string |

Try it answered in this tab

curl

```bash
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

```typescript
import { sandbox } from "@intentic/sandbox-client";

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

More in Models and accounts

[Previous ← Accounts](https://intentic.dev/api/accounts/)[Next Routed providers →](https://intentic.dev/api/translator/)
