Reference

Changelog

What changed in the platform and in this documentation, by date.

Updated 2026-09-23

2026-09-23

  • Switch engines: PATCH /api/v2/agents/:id accepts engine (optional model). 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/:id takes promptMode (append | replace); with replace the 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 .yaml recipe.
  • Agent configuration API (/api/v2/agents/:id): identity, model, files, skills and MCP servers with the agent's token. ghosty-agent skill 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/acp moves to (redirects).
  • /openapi.yaml and /llms.txt available.

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 revive before 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-acp published on npm (MIT, zero dependencies).