Reference
Changelog
Updated 2026-09-23
2026-09-23
- Switch engines:
PATCH /api/v2/agents/:idacceptsengine(optionalmodel). The agent keeps its identity, skills, knowledge, channels and permissions; conversation memory stays with the previous engine. - A new machine for an agent (after it is recycled) now starts with the skills and files you uploaded; before, it only got the identity.
- Google Drive connector: the agent reads the sheets, docs and CSVs you pick in Google's picker, and can append rows or update cells. It only sees what you pick. See .
2026-09-21
- Overridable system prompt:
PATCH /api/v2/agents/:idtakespromptMode(append|replace); withreplacethe agent is only your identity, without the Ghosty persona. The house persona now answers in the language it is written to (it used to force Spanish).
2026-09-16
- Docs for agents: every page exists as markdown at
<url>.md; "Copy markdown", "Open in Claude / ChatGPT" buttons and the MCP block; at/mcp/docs(search_docs,read_doc,list_docs,openapi); copyable prompts per guide; curl/TypeScript/Python tabs; "Try it" in the reference with your token. - Agent creator v2: Describe / Template / Blank, eight house , upload or download an agent's
.yamlrecipe. - Agent configuration API (
/api/v2/agents/:id): identity, model, files, skills and MCP servers with the agent's token.ghosty-agentskill for Claude Code/Cursor/Codex:npx skills add https://ghosty.studio. Guide: . - The web chat now delivers PDFs and documents to the agent (it used to fail with "could not deliver").
- WhatsApp per agent: on the agent card turn on the channel and tick which numbers (connected from Sales) it answers.
- Hand over an agent to another account with its configuration, memory and files (card → Avanzado).
- What the agent delivers (documents, images) is saved in your account files and shown on the web.
- Archived conversations no longer show in the list.
- This documentation is born: getting started, concepts, channels, connectors, protocols (ACP, A2A, MCP), API with OpenAPI 3.1, events, errors.
/docs/acpmoves to (redirects)./openapi.yamland/llms.txtavailable.
2026-09-14
- Correct mid-turn: writing to the agent while it works enters the running turn instead of waiting for it to finish (Teams and API).
- The stream batches tokens on mobile so as not to saturate the UI.
2026-09-11
- Scheduled turns: the agent can work for days without anyone connected (
POST …/schedule).
2026-09-09
- Connectors in the mobile app: EasyBits as the first live connector.
2026-09-02
- An ACP agent comes back up on its own if its machine disappeared: transparent
revivebefore the first message.
2026-08-27
- Attachments are delivered as access to the file: the agent reads it with its tools instead of receiving an inline copy.
2026-08-26
ghosty-acppublished on npm (MIT, zero dependencies).