diff --git a/README.md b/README.md
index b6e1e514..208c2c7c 100644
--- a/README.md
+++ b/README.md
@@ -1,114 +1,755 @@
+
+
+

+
# HelloNear
-> Built at NEAR HACKATHON (1–14 Nov 2026). Status on 11 Nov: the web app https://app.hellonear.xyz runs on the hosted API (try-out needs no wallet): chat with a live view of the Mind's work, approvals, wallet limits (per payment, per day, allowed addresses) and freeze, skills, connections, Autopilot jobs with a visual Builder, the Attack playground, a Telegram bot per Mind, app skills that can change a Sheet, Calendar, Notion or Doc with the old value shown first, Zoom, and Mind settings (memory you can see, edit and clear; rules for what the Mind may do without asking). The API steps below work without the web app.
+### An AI agent that can pay for you, with the money rules out of its reach.
+
+HelloNear gives a person a **Mind**: an AI agent with a persona, memory, skills it can equip and its own NEAR wallet. It reads your email, works in your apps and pays your bills, but **every limit that matters sits outside the model**: the owner approves, and the wallet's policy is checked inside a TEE before anything is signed. Every reply comes from NEAR AI Cloud's TEE with a proof you can check yourself.
+
+
+
+
+
+
+
+
+
+
+
+
+
+### Live now
+
+| | |
+|---|---|
+| **Web app** (no account needed: *Continue as guest*) | **[app.hellonear.xyz](https://app.hellonear.xyz)** |
+| **Landing page** | **[hellonear.xyz](https://hellonear.xyz)** |
+| **API** (NEAR testnet) | **[api.hellonear.xyz/v1/health](https://api.hellonear.xyz/v1/health)** |
+| **Mind registry contract** | **[`hellonear-registry.testnet`](https://testnet.nearblocks.io/address/hellonear-registry.testnet)** (v0.3.0, NEP-330) |
+| **API reference** | **[OpenAPI spec](docs/openapi.json)** · [README section](#api-reference) |
+| **Repository** | **[github.com/Hellonear-AI/hellonear](https://github.com/Hellonear-AI/hellonear)** |
+
+**[The agent and its 50 tools](#the-agent-mastra-on-near-ai-cloud)** ·
+**[Receipts](#receipts-check-them-yourself)** ·
+**[Security model](#security-model)** ·
+**[Try it](#try-it)** ·
+**[API reference](#api-reference)** ·
+**[Limits](#limits)**
+
+Built at **NEAR HACKATHON** (1 to 14 Nov 2026) for six tracks: `security`, `privacy`, `agents`, `swarms`, `business`, `realworld`.
+
+
-HelloNear lets a person run an AI agent (a "Mind") that can read their email and pay on their behalf, while the money rules sit outside the AI's reach. Each Mind has a persona, memory, skills it can equip, and its own NEAR wallet on testnet.
+

+
+
The three Mind templates: General Assistant, Payments Mind, Email Manager.
+
+
+
+---
## The problem
-An AI assistant that can pay is one prompt injection away from paying the wrong person. A rule written in the system prompt ("never send more than X") is advice to the model, not a limit: a malicious email can talk the model out of it. HelloNear moves the limits out of the model:
+An AI assistant that can pay is one prompt injection away from paying the wrong person. A rule written in the system prompt ("never send more than X") is advice to the model, not a limit: a malicious email, calendar invite or web page can talk the model out of it. And an AI that reads your private email should not leak it to the infrastructure it runs on.
+
+HelloNear's answer is to **take the limits out of the model** and **make the model's work verifiable**:
+
+1. **Every payment asks the owner,** in the app or in Telegram, unless the owner turned on a rule for small payments to listed addresses. Without an approval or a rule, the payment tool cannot run.
+2. **The wallet enforces its own policy.** Each Mind's wallet is an [OutLayer](https://outlayer.ai) wallet whose policy (per-payment limit, daily limit, allowed recipients) is stored on NEAR and checked in a TEE before anything is signed. A payment over the limit or to an unknown address is refused **even if the owner approved it**, and no transaction exists.
+3. **Freeze.** One transaction, signed in the owner's own NEAR wallet, stops everything.
+4. **Private, verifiable inference.** Every model call runs on NEAR AI Cloud inside a TEE. HelloNear checks each reply's signature against the hardware attestation before it shows the "Verified" badge, keeps that proof, and lets anyone open it on Phala's TEE Attestation Explorer.
+
+---
+
+## What it does
+
+| Feature | What it means |
+|---|---|
+| **A Mind per job** | Pick a template (General Assistant, Payments Mind, Email Manager), give it a name and a voice. It remembers what matters, and you can read, edit or clear that memory. |
+| **Skills grant tools** | 33 skills, each a playbook plus a fixed list of tools. A Mind has exactly the tools its skills grant, so a Mind without a payment skill cannot pay, whatever it is told. |
+| **Approval cards** | Payments, emails, calendar changes, Sheets cells, Notion rows, Docs, Slack posts and Zoom meetings wait for the owner, with the old value shown next to the new one. |
+| **A wallet with its own rules** | Per-payment limit, daily limit and allowed addresses, enforced by OutLayer in a TEE before signing; freeze with one signature. |
+| **Cross-chain quotes** | A Payments Mind quotes a USDC or USDT payment from NEAR to Base, Solana, Arbitrum and more through **NEAR Intents**, with 1Click's signature checked. |
+| **Proof behind every reply** | View proof shows each step's signature and Intel's TDX report; *Check it in TEE Explorer* opens a report that reads VERIFIED. |
+| **Autopilot** | A visual Builder for scheduled jobs (Ask the Mind, Use a tool, Call a website, If or else). Jobs run unattended, so they get no payment tools at all. |
+| **Attack playground** | Try to trick a test Mind into paying and see which layer stopped it. |
+| **Telegram** | Chat with your Mind from Telegram, with streamed replies and Approve / Decline buttons. |
+| **Your apps** | Gmail, Google Calendar and Meet, Sheets, Drive, Docs, Notion, Slack, Outlook and Zoom through Composio, plus the Mind's own email address. |
+
+---
+
+## Tracks
+
+HelloNear is submitted to six tracks. For each one: what the organizers ask for (quoted from the *Build* and *Hints* columns of HACKATHON.md), what HelloNear built for it, the skills that carry it, and how to check it.
+
+| Track | Why HelloNear fits, in one line |
+|---|---|
+| [`security`](#security-ai-security--defense) | An AI with money whose limits it cannot touch: approval, an OutLayer policy checked in a TEE before signing, freeze, scam and lookalike checks, and an Attack playground |
+| [`privacy`](#privacy-privacy--private-ai) | Every reply runs on NEAR AI Cloud in a TEE and is verified against its attestation, with a proof anyone can open on Phala's TEE Explorer |
+| [`agents`](#agents-agent-economy) | Minds pay for data (402), sell to other Minds, compare sellers, invoice, and quote payments through NEAR Intents, inside the owner's limits |
+| [`swarms`](#swarms-ai-swarms) | Every purchase is a small auction between sellers; Minds trade with other Minds; one request pays several people, each approved |
+| [`business`](#business-autonomous-business) | The owner sets the constraints; the Mind runs the treasury: reports, audits, revenue sharing, invoices, procurement, scheduled jobs |
+| [`realworld`](#realworld-real-world-money) | Invoices with payment checked on chain, bills found in Gmail, and stablecoin payments to other chains quoted through NEAR Intents |
+
+### `security`: AI Security & Defense
+
+| | |
+|---|---|
+| **The track asks for** | "Build spending limits, policy engines, sandboxed wallets, reputation and scam detection. Give AI money without giving it the keys to everything." Hints: agent security, function call keys, TEE attestation |
+| **What HelloNear built** | Seven layers that each stop an attack alone: the model, skills that grant tools, the owner's approval, the OutLayer wallet policy checked **in a TEE before signing**, a daily limit, freeze, and unattended jobs with no payment tools. Writes re-check their target before writing. A Recipient guard against lookalike accounts, a Phishing check, and an Attack playground that names the layer that stopped each attack. Why not function-call keys: they cannot transfer NEAR and their allowance is gas, not a spending cap |
+| **Skills** | Recipient guard, Phishing check, Freeze advisor, Spending audit, Payments |
+| **Check it** | Attack playground, any scenario: `attack.verdict` names the layer. Approve 1 NEAR: `policy_denied`, no transaction |
+
+### `privacy`: Privacy & Private AI
+
+| | |
+|---|---|
+| **The track asks for** | "Explore confidential computation, private finance and AI that protects sensitive data. Build intelligence without exposure." Hints: private AI, TEE, NEAR AI Cloud |
+| **What HelloNear built** | Every model call runs on **NEAR AI Cloud** inside a TEE. Each reply's signature is checked against the hardware attestation before the Verified badge shows; the proof is kept, shown under View proof, and opens on Phala's TEE Explorer as VERIFIED. Secrets and wallet tokens never reach the model, traces or stored snapshots. Skills that read sensitive email without sending it anywhere |
+| **Skills** | Confidential reader, Redact before send, Health journal |
+| **Check it** | Verified badge → View proof → Check it in TEE Explorer: a VERIFIED report whose nonce matches the dialog |
+
+### `agents`: Agent Economy
+
+| | |
+|---|---|
+| **The track asks for** | "Build agents that earn, spend, negotiate, hire other agents and pay for APIs, compute or data — with crypto directly or through NEAR Intents." Hints: agent commerce, NEAR Intents, chain signatures |
+| **What HelloNear built** | Minds pay for data with a 402 pattern on testnet NEAR (price, approved payment, report with the tx hash as receipt), sell what they made to other Minds into their own wallet, compare sellers before buying, invoice and check payment on chain, and quote cross-chain payments through **NEAR Intents**. All inside the owner's limits |
+| **Skills** | Paid data, Best price buyer, Price watch, Mind as seller, Invoice & get paid, Payments |
+| **Check it** | *"What's the gas price on NEAR testnet? Buy the report."*: a `402` price, a card for 0.001 NEAR, then the report and its tx hash |
+
+### `swarms`: AI Swarms
+
+| | |
+|---|---|
+| **The track asks for** | "Build coordination markets, bidding, collective purchasing, intent-based settlement and emergent economies between agents." Hints: multi-agent systems, NEAR Intents, sub-accounts |
+| **What HelloNear built** | Best price buyer runs each order as a small auction between sellers and buys only from one the wallet may pay; Minds buy from and sell to other Minds (each with its own wallet); Split bill and Revenue split pay several people from one request, each payment approved on its own |
+| **Skills** | Best price buyer, Mind as seller, Split bill, Revenue split |
+| **Check it** | *"Split 0.02 NEAR between alice.testnet and bob.testnet"*: shares worked out in yoctoNEAR, one card per person |
+
+### `business`: Autonomous Business
+
+| | |
+|---|---|
+| **The track asks for** | "Build AI-native businesses with treasury, sales, procurement, cross-chain payments via NEAR Intents and revenue sharing. Humans only set the constraints." Hints: AI agents, NEAR Intents, chain signatures |
+| **What HelloNear built** | The owner sets the constraints (limits, recipients, rules); the Mind runs the treasury: daily treasury reports, a weekly spending audit, revenue sharing between partners, invoices and follow-ups, procurement through Best price buyer, cross-chain quotes through NEAR Intents, and Autopilot jobs that run on a schedule |
+| **Skills** | Treasury report, Spending audit, Revenue split, Invoice & get paid, Follow-ups, Subscriptions & bills |
+| **Check it** | *"Give me today's treasury report"*: balance, what went out, what is pending, read only |
+
+### `realworld`: Real-World Money
+
+| | |
+|---|---|
+| **The track asks for** | "Build payroll, invoicing, remittances, merchant payments and stablecoin rails for real businesses. Something a normal company could use tomorrow." Hints: stablecoins, NEAR Intents, meta transactions |
+| **What HelloNear built** | Invoices sent from the Mind's own email address with payment checked by its transaction on chain; bills and subscriptions found in the owner's Gmail; USDC/USDT payments to other chains quoted through **NEAR Intents**, signed by 1Click and checked with the official SDK (sending needs mainnet); every payment approved by the owner and limited by the wallet |
+| **Skills** | Invoice & get paid, Subscriptions & bills, Spending tracker, Payments |
+| **Check it** | *"Send 10 USDC to 0x8ba1f109551bD432803012645Ac136ddd64DBA72 on Base."*: what would arrive, the cost, the time, `proof.signedBy1Click: true`, nothing sent |
+
+---
+
+## Connectors
+
+What a Mind can work with. Logos are the ones the web app shows on the Connections screen (rendered from `apps/fe/src/components/elements/AppLogos.tsx`); each is its owner's trademark, used to name the app.
+
+| | Connector | How it connects | What a Mind can do with it |
+|---|---|---|---|
+|
+
+**HelloNear**: the AI does the work; the limits stay with you.
+
+Built on NEAR testnet for **NEAR HACKATHON**.
-## Team rules
+*Every claim on this page links to something you can check without asking us.*
-- No push to `main`, merge, PR, or submission without Axel's approval. An approved merge to `main` is then deployed to the hosted testnet demo automatically (`deploy/README.md`).
-- Local integration and load tests before every push/merge; results reported in the PR.
-- Secrets only in `.env` (gitignored). Variable names are in each folder's `.env.example`.
-- When you change how a folder works, update its `CLAUDE.md` in the same PR. Setup for agents: #23.
+
## License
diff --git a/docs/openapi.json b/docs/openapi.json
new file mode 100644
index 00000000..058faf6a
--- /dev/null
+++ b/docs/openapi.json
@@ -0,0 +1,2042 @@
+{
+ "openapi": "3.1.0",
+ "info": {
+ "title": "HelloNear API",
+ "version": "1.0.0",
+ "description": "The public HTTP API behind https://app.hellonear.xyz (NEAR testnet). Sign in with a NEAR wallet (NEP-413: `/v1/auth/challenge`, then `/v1/auth/login`) or start a try-out session with `POST /v1/auth/demo`; both set the `hn_session` cookie. Chat, approvals, attack and workflow runs stream server-sent events; every event type is described in docs/api-contract.md \u00a73."
+ },
+ "servers": [
+ {
+ "url": "https://api.hellonear.xyz",
+ "description": "Hosted demo (NEAR testnet)"
+ },
+ {
+ "url": "http://localhost:4000",
+ "description": "Local"
+ }
+ ],
+ "security": [
+ {
+ "session": []
+ }
+ ],
+ "components": {
+ "securitySchemes": {
+ "session": {
+ "type": "apiKey",
+ "in": "cookie",
+ "name": "hn_session"
+ }
+ }
+ },
+ "paths": {
+ "/v1/health": {
+ "get": {
+ "tags": [
+ "System"
+ ],
+ "summary": "Health of the backend and the engine",
+ "responses": {
+ "200": {
+ "description": "`{ ok, engine, revision }`"
+ }
+ },
+ "security": []
+ }
+ },
+ "/v1/auth/challenge": {
+ "post": {
+ "tags": [
+ "Auth"
+ ],
+ "summary": "Get a NEP-413 sign-in message and a one-time nonce",
+ "responses": {
+ "200": {
+ "description": "`{ message, recipient, nonce }` (nonce: 32 bytes base64, single use, 5 minutes)"
+ }
+ },
+ "security": []
+ }
+ },
+ "/v1/auth/login": {
+ "post": {
+ "tags": [
+ "Auth"
+ ],
+ "summary": "Sign in with a NEAR wallet signature (NEP-413)",
+ "responses": {
+ "200": {
+ "description": "`{ user: { id, nearAccountId } }` and the `hn_session` cookie; `401 invalid_nonce | invalid_signature`"
+ }
+ },
+ "requestBody": {
+ "required": true,
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "accountId": {
+ "type": "string"
+ },
+ "publicKey": {
+ "type": "string"
+ },
+ "signature": {
+ "type": "string"
+ },
+ "nonce": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "accountId",
+ "publicKey",
+ "signature",
+ "nonce"
+ ]
+ }
+ }
+ }
+ },
+ "security": []
+ }
+ },
+ "/v1/auth/demo": {
+ "post": {
+ "tags": [
+ "Auth"
+ ],
+ "summary": "Start a try-out (guest) session: no wallet, 20 messages",
+ "responses": {
+ "201": {
+ "description": "`201 { user: { id, nearAccountId: \"demo:\u2026\", demo: true } }` and the session cookie"
+ }
+ },
+ "requestBody": {
+ "required": true,
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {}
+ }
+ }
+ }
+ },
+ "security": []
+ }
+ },
+ "/v1/auth/logout": {
+ "post": {
+ "tags": [
+ "Auth"
+ ],
+ "summary": "Sign out",
+ "responses": {
+ "204": {
+ "description": "`204`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ }
+ }
+ },
+ "/v1/me": {
+ "get": {
+ "tags": [
+ "Auth"
+ ],
+ "summary": "The signed-in user",
+ "responses": {
+ "200": {
+ "description": "`{ user }` (`user.demo: true` for a try-out user)"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ }
+ }
+ },
+ "/v1/templates": {
+ "get": {
+ "tags": [
+ "Catalog"
+ ],
+ "summary": "Mind templates",
+ "responses": {
+ "200": {
+ "description": "`{ templates }`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ }
+ }
+ },
+ "/v1/skills": {
+ "get": {
+ "tags": [
+ "Catalog"
+ ],
+ "summary": "Every skill a Mind can equip, with its tools",
+ "responses": {
+ "200": {
+ "description": "`{ skills }`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ }
+ }
+ },
+ "/v1/skills/{skillId}": {
+ "get": {
+ "tags": [
+ "Catalog"
+ ],
+ "summary": "One skill with its playbook (SKILL.md body)",
+ "responses": {
+ "200": {
+ "description": "`{ skill: { skillId, title, blurb, status, connections, tools, markdown } }`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "skillId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ]
+ }
+ },
+ "/v1/minds": {
+ "get": {
+ "tags": [
+ "Minds"
+ ],
+ "summary": "The user's Minds, newest first",
+ "responses": {
+ "200": {
+ "description": "`{ minds }`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ }
+ },
+ "post": {
+ "tags": [
+ "Minds"
+ ],
+ "summary": "Create a Mind from a template",
+ "responses": {
+ "201": {
+ "description": "`201 { mind }`; `400 unknown_template | unknown_skill | duplicate_skill`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "requestBody": {
+ "required": true,
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "templateId": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "soul": {
+ "type": "object"
+ },
+ "model": {
+ "type": "string"
+ },
+ "skills": {
+ "type": "array"
+ }
+ },
+ "required": [
+ "templateId",
+ "name"
+ ]
+ }
+ }
+ }
+ }
+ }
+ },
+ "/v1/minds/{mindId}": {
+ "get": {
+ "tags": [
+ "Minds"
+ ],
+ "summary": "One Mind",
+ "responses": {
+ "200": {
+ "description": "`{ mind }`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "mindId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ]
+ },
+ "patch": {
+ "tags": [
+ "Minds"
+ ],
+ "summary": "Change a Mind: name, voice, model, skills, memory switches, auto-approve rules",
+ "responses": {
+ "200": {
+ "description": "`{ mind }`. `autoApprove` = `{ tools: [toolId], payment: { maxNear } | null }`; try-out users get `403 demo_not_allowed` for rules"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "mindId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "requestBody": {
+ "required": true,
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "soul": {
+ "type": "object"
+ },
+ "model": {
+ "type": "string"
+ },
+ "skills": {
+ "type": "array"
+ },
+ "memory": {
+ "type": "object"
+ },
+ "autoApprove": {
+ "type": "object"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "delete": {
+ "tags": [
+ "Minds"
+ ],
+ "summary": "Delete a Mind (and its workflows, schedules and wallet key)",
+ "responses": {
+ "200": {
+ "description": "`204`; `409 wallet_not_empty { balanceNear }` unless `?acknowledgeBalance=true`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "mindId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "acknowledgeBalance",
+ "in": "query",
+ "schema": {
+ "type": "boolean"
+ }
+ }
+ ]
+ }
+ },
+ "/v1/minds/{mindId}/chat": {
+ "post": {
+ "tags": [
+ "Chat"
+ ],
+ "summary": "Send a message; the reply streams as server-sent events",
+ "responses": {
+ "200": {
+ "description": "SSE: `run.started`, `step.*`, `text.delta`, `tool.called`, `tool.result`, `tool.approval_required`, `run.finished`, `run.verified`, \u2026",
+ "content": {
+ "text/event-stream": {
+ "schema": {
+ "type": "string"
+ }
+ }
+ }
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "mindId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "requestBody": {
+ "required": true,
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "timeZone": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message"
+ ]
+ }
+ }
+ }
+ }
+ }
+ },
+ "/v1/minds/{mindId}/threads": {
+ "get": {
+ "tags": [
+ "Chat"
+ ],
+ "summary": "Chat threads, newest first",
+ "responses": {
+ "200": {
+ "description": "`{ threads: [{ threadId, title, lastMessageAt, messageCount }] }`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "mindId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "limit",
+ "in": "query",
+ "schema": {
+ "type": "integer"
+ }
+ }
+ ]
+ }
+ },
+ "/v1/minds/{mindId}/threads/{threadId}/messages": {
+ "get": {
+ "tags": [
+ "Chat"
+ ],
+ "summary": "A thread's messages, oldest first, paged by `before`",
+ "responses": {
+ "200": {
+ "description": "`{ messages: [{ id, role, text, createdAt, runId }], nextBefore }`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "mindId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "threadId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "limit",
+ "in": "query",
+ "schema": {
+ "type": "integer"
+ }
+ },
+ {
+ "name": "before",
+ "in": "query",
+ "schema": {
+ "type": "string"
+ }
+ }
+ ]
+ }
+ },
+ "/v1/minds/{mindId}/threads/{threadId}": {
+ "patch": {
+ "tags": [
+ "Chat"
+ ],
+ "summary": "Rename a thread",
+ "responses": {
+ "200": {
+ "description": "`{ thread }`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "mindId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "threadId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "requestBody": {
+ "required": true,
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "title": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "title"
+ ]
+ }
+ }
+ }
+ }
+ },
+ "delete": {
+ "tags": [
+ "Chat"
+ ],
+ "summary": "Delete a thread for good (the engine forgets it too)",
+ "responses": {
+ "200": {
+ "description": "`204`; `409 thread_busy` while a run is running or waiting"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "mindId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "threadId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ]
+ }
+ },
+ "/v1/minds/{mindId}/runs": {
+ "get": {
+ "tags": [
+ "Runs"
+ ],
+ "summary": "Runs of a Mind, with tokens and cost",
+ "responses": {
+ "200": {
+ "description": "`{ runs: [{ runId, threadId, workflowId, status, model, usage, costUsd, startedAt, finishedAt }] }`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "mindId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "limit",
+ "in": "query",
+ "schema": {
+ "type": "integer"
+ }
+ }
+ ]
+ }
+ },
+ "/v1/runs/{runId}": {
+ "get": {
+ "tags": [
+ "Runs"
+ ],
+ "summary": "One run with all its stored events",
+ "responses": {
+ "200": {
+ "description": "`{ run, events }`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "runId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ]
+ }
+ },
+ "/v1/runs/{runId}/proof": {
+ "get": {
+ "tags": [
+ "Verification"
+ ],
+ "summary": "The proof behind a reply's Verified badge",
+ "responses": {
+ "200": {
+ "description": "`{ runId, proofs: [{ seq, model, level, proof: { checkedAt, steps, attestations } }] }`; `404 no_proof`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "runId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ]
+ }
+ },
+ "/v1/runs/{runId}/proof/tee-explorer": {
+ "post": {
+ "tags": [
+ "Verification"
+ ],
+ "summary": "Upload the run's Intel quote to Phala's TEE Explorer and get the verified report",
+ "responses": {
+ "200": {
+ "description": "`{ runId, reports: [{ attestation, kind, url, verified }] }`; `404 no_proof`; `503 tee_explorer_unreachable | tee_explorer_error`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "runId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "requestBody": {
+ "required": true,
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {}
+ }
+ }
+ }
+ }
+ }
+ },
+ "/v1/minds/{mindId}/approvals": {
+ "get": {
+ "tags": [
+ "Approvals"
+ ],
+ "summary": "Runs waiting for the owner's approval",
+ "responses": {
+ "200": {
+ "description": "`{ approvals: [{ runId, threadId, toolCallId, tool, args, requestedAt }] }`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "mindId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ]
+ }
+ },
+ "/v1/runs/{runId}/approve": {
+ "post": {
+ "tags": [
+ "Approvals"
+ ],
+ "summary": "Approve a waiting tool call; the run resumes as SSE",
+ "responses": {
+ "200": {
+ "description": "SSE continuing the run; `409 not_awaiting_approval`",
+ "content": {
+ "text/event-stream": {
+ "schema": {
+ "type": "string"
+ }
+ }
+ }
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "runId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "requestBody": {
+ "required": true,
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "toolCallId": {
+ "type": "string"
+ },
+ "timeZone": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "toolCallId"
+ ]
+ }
+ }
+ }
+ }
+ }
+ },
+ "/v1/runs/{runId}/decline": {
+ "post": {
+ "tags": [
+ "Approvals"
+ ],
+ "summary": "Decline a waiting tool call; the run resumes as SSE",
+ "responses": {
+ "200": {
+ "description": "SSE continuing the run; `409 not_awaiting_approval`",
+ "content": {
+ "text/event-stream": {
+ "schema": {
+ "type": "string"
+ }
+ }
+ }
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "runId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "requestBody": {
+ "required": true,
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "toolCallId": {
+ "type": "string"
+ },
+ "reason": {
+ "type": "string"
+ },
+ "timeZone": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "toolCallId"
+ ]
+ }
+ }
+ }
+ }
+ }
+ },
+ "/v1/runs/{runId}/cancel": {
+ "post": {
+ "tags": [
+ "Runs"
+ ],
+ "summary": "Stop a run that is still streaming",
+ "responses": {
+ "200": {
+ "description": "`{ run }` once `run.finished { status: \"canceled\" }` is stored; `409 not_running`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "runId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "requestBody": {
+ "required": true,
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {}
+ }
+ }
+ }
+ }
+ }
+ },
+ "/v1/minds/{mindId}/events": {
+ "get": {
+ "tags": [
+ "Runs"
+ ],
+ "summary": "Events across runs since a time (Mind Graph history)",
+ "responses": {
+ "200": {
+ "description": "`{ events }`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "mindId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "since",
+ "in": "query",
+ "schema": {
+ "type": "string",
+ "format": "date-time"
+ }
+ },
+ {
+ "name": "limit",
+ "in": "query",
+ "schema": {
+ "type": "integer"
+ }
+ }
+ ]
+ }
+ },
+ "/v1/minds/{mindId}/wallet": {
+ "post": {
+ "tags": [
+ "Wallet"
+ ],
+ "summary": "Create the Mind's OutLayer wallet (testnet)",
+ "responses": {
+ "201": {
+ "description": "`201 { wallet }`; `409 wallet_exists`; try-out users `403`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "mindId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "requestBody": {
+ "required": true,
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {}
+ }
+ }
+ }
+ }
+ },
+ "get": {
+ "tags": [
+ "Wallet"
+ ],
+ "summary": "Balance, spent today, frozen, and the policy",
+ "responses": {
+ "200": {
+ "description": "`{ wallet: { address, shared, balanceNear, spentTodayNear, frozen, policy } }`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "mindId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ]
+ }
+ },
+ "/v1/minds/{mindId}/wallet/payments": {
+ "get": {
+ "tags": [
+ "Wallet"
+ ],
+ "summary": "Payment receipts, refused ones included",
+ "responses": {
+ "200": {
+ "description": "`{ payments }`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "mindId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "limit",
+ "in": "query",
+ "schema": {
+ "type": "integer"
+ }
+ }
+ ]
+ }
+ },
+ "/v1/minds/{mindId}/wallet/policy": {
+ "post": {
+ "tags": [
+ "Wallet"
+ ],
+ "summary": "Build a store_wallet_policy transaction for the owner to sign",
+ "responses": {
+ "200": {
+ "description": "`{ transaction }` for the owner's NEAR wallet to sign (`outlayer.testnet`)"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "mindId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "requestBody": {
+ "required": true,
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "perTransactionNear": {
+ "type": "string"
+ },
+ "dailyNear": {
+ "type": "string"
+ },
+ "whitelist": {
+ "type": "array"
+ }
+ },
+ "required": [
+ "perTransactionNear",
+ "whitelist"
+ ]
+ }
+ }
+ }
+ }
+ }
+ },
+ "/v1/minds/{mindId}/wallet/freeze": {
+ "post": {
+ "tags": [
+ "Wallet"
+ ],
+ "summary": "Build a freeze_wallet transaction for the owner to sign",
+ "responses": {
+ "200": {
+ "description": "`{ transaction }`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "mindId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "requestBody": {
+ "required": true,
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {}
+ }
+ }
+ }
+ }
+ }
+ },
+ "/v1/minds/{mindId}/wallet/unfreeze": {
+ "post": {
+ "tags": [
+ "Wallet"
+ ],
+ "summary": "Build an unfreeze_wallet transaction for the owner to sign",
+ "responses": {
+ "200": {
+ "description": "`{ transaction }`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "mindId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "requestBody": {
+ "required": true,
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {}
+ }
+ }
+ }
+ }
+ }
+ },
+ "/v1/minds/{mindId}/memory": {
+ "get": {
+ "tags": [
+ "Memory"
+ ],
+ "summary": "What the Mind remembers about the owner",
+ "responses": {
+ "200": {
+ "description": "`{ memory: { markdown, updatedAt } }`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "mindId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ]
+ },
+ "put": {
+ "tags": [
+ "Memory"
+ ],
+ "summary": "Replace the Mind's memory",
+ "responses": {
+ "200": {
+ "description": "`{ memory }`; try-out users `403 demo_not_allowed`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "mindId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "requestBody": {
+ "required": true,
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "markdown": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "markdown"
+ ]
+ }
+ }
+ }
+ }
+ },
+ "delete": {
+ "tags": [
+ "Memory"
+ ],
+ "summary": "Clear the Mind's memory",
+ "responses": {
+ "204": {
+ "description": "`204`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "mindId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ]
+ }
+ },
+ "/v1/minds/{mindId}/inbox": {
+ "get": {
+ "tags": [
+ "Email"
+ ],
+ "summary": "The Mind's own email address, if any",
+ "responses": {
+ "200": {
+ "description": "`{ inbox: null | { email, shared } }`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "mindId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ]
+ },
+ "post": {
+ "tags": [
+ "Email"
+ ],
+ "summary": "Create the Mind's own email address (AgentMail)",
+ "responses": {
+ "201": {
+ "description": "`201 { inbox }`; `409 email_skill_off`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "mindId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "requestBody": {
+ "required": true,
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {}
+ }
+ }
+ }
+ }
+ }
+ },
+ "/v1/minds/{mindId}/mail/sent": {
+ "get": {
+ "tags": [
+ "Email"
+ ],
+ "summary": "Emails the Mind sent, refusals included",
+ "responses": {
+ "200": {
+ "description": "`{ sends }`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "mindId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "limit",
+ "in": "query",
+ "schema": {
+ "type": "integer"
+ }
+ }
+ ]
+ }
+ },
+ "/v1/minds/{mindId}/workflows": {
+ "get": {
+ "tags": [
+ "Autopilot"
+ ],
+ "summary": "Saved Builder workflows",
+ "responses": {
+ "200": {
+ "description": "`{ workflows: [{ workflowId, name, tools, schedule, updatedAt }] }`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "mindId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ]
+ }
+ },
+ "/v1/minds/{mindId}/workflows/{workflowId}": {
+ "put": {
+ "tags": [
+ "Autopilot"
+ ],
+ "summary": "Save a Builder canvas (compiled to a Mastra workflow)",
+ "responses": {
+ "200": {
+ "description": "`{ workflowId, tools, steps, schedule, autopilot }`; `400 invalid_workflow { issues }`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "mindId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "workflowId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "requestBody": {
+ "required": true,
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "nodes": {
+ "type": "array"
+ },
+ "edges": {
+ "type": "array"
+ }
+ },
+ "required": [
+ "name",
+ "nodes",
+ "edges"
+ ]
+ }
+ }
+ }
+ }
+ },
+ "get": {
+ "tags": [
+ "Autopilot"
+ ],
+ "summary": "One workflow with its canvas",
+ "responses": {
+ "200": {
+ "description": "`{ workflowId, name, tools, schedule, updatedAt, canvas, steps }`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "mindId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "workflowId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ]
+ },
+ "delete": {
+ "tags": [
+ "Autopilot"
+ ],
+ "summary": "Delete a workflow and its schedule",
+ "responses": {
+ "204": {
+ "description": "`204`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "mindId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "workflowId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ]
+ }
+ },
+ "/v1/minds/{mindId}/workflows/{workflowId}/runs": {
+ "post": {
+ "tags": [
+ "Autopilot"
+ ],
+ "summary": "Run a workflow now; steps stream as SSE",
+ "responses": {
+ "200": {
+ "description": "SSE: `workflow.started`, `node.started`, `node.finished`, `workflow.finished`; `409 missing_tools`",
+ "content": {
+ "text/event-stream": {
+ "schema": {
+ "type": "string"
+ }
+ }
+ }
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "mindId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "workflowId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "requestBody": {
+ "required": true,
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "input": {
+ "type": "object"
+ },
+ "timeZone": {
+ "type": "string"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "get": {
+ "tags": [
+ "Autopilot"
+ ],
+ "summary": "Past runs of a workflow, newest first, with each step",
+ "responses": {
+ "200": {
+ "description": "`{ runs }`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "mindId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "workflowId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "limit",
+ "in": "query",
+ "schema": {
+ "type": "integer"
+ }
+ }
+ ]
+ }
+ },
+ "/v1/minds/{mindId}/workflows/{workflowId}/autopilot": {
+ "put": {
+ "tags": [
+ "Autopilot"
+ ],
+ "summary": "Turn the schedule on (wallet sign-in only)",
+ "responses": {
+ "200": {
+ "description": "`{ autopilot }`; `409 cannot_autopilot`; try-out users `403`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "mindId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "workflowId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "requestBody": {
+ "required": true,
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "input": {
+ "type": "object"
+ },
+ "enabled": {
+ "type": "boolean"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "get": {
+ "tags": [
+ "Autopilot"
+ ],
+ "summary": "The schedule's state",
+ "responses": {
+ "200": {
+ "description": "`{ autopilot }`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "mindId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "workflowId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ]
+ },
+ "delete": {
+ "tags": [
+ "Autopilot"
+ ],
+ "summary": "Turn the schedule off",
+ "responses": {
+ "204": {
+ "description": "`204`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "mindId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "workflowId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ]
+ }
+ },
+ "/v1/connections": {
+ "get": {
+ "tags": [
+ "Connections"
+ ],
+ "summary": "Apps the user connected through Composio",
+ "responses": {
+ "200": {
+ "description": "`{ connections: [{ toolkit, status, \u2026 }] }`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ }
+ }
+ },
+ "/v1/connections/{toolkit}": {
+ "post": {
+ "tags": [
+ "Connections"
+ ],
+ "summary": "Get a Composio Connect Link for an app",
+ "responses": {
+ "200": {
+ "description": "`{ redirectUrl }`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "toolkit",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "requestBody": {
+ "required": true,
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {}
+ }
+ }
+ }
+ }
+ },
+ "delete": {
+ "tags": [
+ "Connections"
+ ],
+ "summary": "Disconnect an app",
+ "responses": {
+ "204": {
+ "description": "`204`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "toolkit",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ]
+ }
+ },
+ "/v1/minds/{mindId}/telegram": {
+ "get": {
+ "tags": [
+ "Telegram"
+ ],
+ "summary": "The Mind's Telegram bot, if connected",
+ "responses": {
+ "200": {
+ "description": "`{ telegram }`"
+ },
+ "401": {
+ "description": "Not signed in"
+ }
+ },
+ "parameters": [
+ {
+ "name": "mindId",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ]
+ },
+ "put": {
+ "tags": [
+ "Telegram"
+ ],
+ "summary": "Connect a BotFather token to the Mind",
+ "responses": {
+ "200": {
+ "description": "`{ telegram }` with a one-time `t.me/