# Ando

> Documentation and API reference for Ando.

## Public API v1

- [Developer overview](https://docs.ando.so/developers/overview.md): Choose the right Ando developer path for agents, MCP, API workflows, realtime, and webhooks.
- [Which key do I use?](https://docs.ando.so/developers/which-key-do-i-use.md): Choose the right Ando credential for Codex, MCP, public API calls, realtime tickets, and webhooks.
- [Developer quickstart](https://docs.ando.so/developers/quickstart.md): Create a member API key and make your first public API request.
- [API overview](https://docs.ando.so/api-reference/overview.md): Build API-key integrations with Ando's public API v1.
- [Authorization](https://docs.ando.so/api-reference/authorization.md): Create an Ando API key, store it safely, and send authenticated API requests.
- [Messaging quickstart](https://docs.ando.so/api-reference/messaging-quickstart.md): Run the stable message workflow from search through replies.
- [Search quickstart](https://docs.ando.so/api-reference/search-quickstart.md): Use stable search endpoints to find messages, conversations, workspace members, and calls.
- [Messaging API](https://docs.ando.so/api-reference/http-api.md): Search, list, create, fetch, and reply to Ando messages.
- [Realtime quickstart](https://docs.ando.so/api-reference/realtime-quickstart.md): Open a realtime connection, listen for events, ack delivery, and resume after reconnect.
- [Webhook guide](https://docs.ando.so/api-reference/webhooks.md): Create a webhook endpoint, verify signed payloads, and inspect generated event docs.
- [SDK guide](https://docs.ando.so/developers/sdk.md): Use @andocorp/sdk for a typed Ando client: REST, realtime subscriptions, webhook management, and webhook receiver helpers.
- [CLI guide](https://docs.ando.so/developers/cli.md): Use @andocorp/cli for terminal auth, public API calls, realtime watching, and webhook workflows.
- [Reusable API snippets](https://docs.ando.so/api-reference/snippets.md): Copy small public API v1 snippets into server-side integrations.
- [Endpoint reference map](https://docs.ando.so/api-reference/endpoint-reference.md): Scan public API v1 endpoints by stability level before opening generated schemas.
- [Webhook Events](https://docs.ando.so/api-reference/webhook-events.md): Generated webhook event reference from the Ando monorepo product event registry.

## Endpoint reference

### Search

- [Search messages](https://docs.ando.so/api-reference/search/search-messages.md): Searches messages in conversations accessible to the authenticated API key.
- [Search conversations](https://docs.ando.so/api-reference/search/search-conversations.md): Searches conversations accessible to the authenticated API key.
- [Search workspace members](https://docs.ando.so/api-reference/search/search-workspace-members.md): Searches workspace members in the authenticated API key workspace. The v1 path keeps the /search/members compatibility spelling.
- [Search calls](https://docs.ando.so/api-reference/search/search-calls.md): Searches calls accessible to the authenticated API key.

### Messaging

- [List conversation messages](https://docs.ando.so/api-reference/messages/list-conversation-messages.md): Returns messages in a conversation.
- [Create a conversation message](https://docs.ando.so/api-reference/messages/create-a-conversation-message.md): Creates a message in a conversation using the authenticated API-key workspace membership as the author.
- [Get a message](https://docs.ando.so/api-reference/messages/get-a-message.md): Returns a single conversation message by identifier.
- [List thread replies](https://docs.ando.so/api-reference/messages/list-thread-replies.md): Returns replies for a thread root message.

### Realtime

- [Open a realtime connection](https://docs.ando.so/api-reference/realtime/open-a-realtime-connection.md): Opens a temporary pre-authorized public realtime websocket connection URL for RFC 085 ProductEvent delivery. API keys are validated only on this HTTP route; the websocket uses the returned temporary ticket URL and the ando.realtime.v1 subprotocol.

### Webhook endpoints

- [Create a webhook endpoint](https://docs.ando.so/api-reference/webhooks/create-a-webhook-endpoint.md): Creates a workspace webhook endpoint and returns its signing secret exactly once.
- [List webhook endpoints](https://docs.ando.so/api-reference/webhooks/list-webhook-endpoints.md): Lists workspace webhook endpoint metadata.
- [Get a webhook endpoint](https://docs.ando.so/api-reference/webhooks/get-a-webhook-endpoint.md): Returns webhook endpoint metadata and a recent delivery summary.
- [Update a webhook endpoint](https://docs.ando.so/api-reference/webhooks/update-a-webhook-endpoint.md): Updates webhook endpoint metadata and delivery settings.
- [Rotate webhook endpoint secret](https://docs.ando.so/api-reference/webhooks/rotate-webhook-endpoint-secret.md): Rotates a webhook endpoint signing secret and returns the new secret exactly once.
- [Send a webhook test event](https://docs.ando.so/api-reference/webhooks/send-a-webhook-test-event.md): Creates a webhook.test event and schedules delivery to one endpoint.

### Webhook deliveries

- [List webhook deliveries](https://docs.ando.so/api-reference/webhooks/list-webhook-deliveries.md): Lists webhook deliveries with optional endpoint, event, status, and creation-time filters.
- [Replay a webhook delivery](https://docs.ando.so/api-reference/webhooks/replay-a-webhook-delivery.md): Creates a fresh scheduled delivery for the same endpoint and event.

### Preview

- [Get a workspace member](https://docs.ando.so/api-reference/members/get-a-workspace-member.md): Returns a workspace member visible to the authenticated API key. The v1 path and memberId parameter are compatibility spellings for a workspace member identifier.
- [Get a call](https://docs.ando.so/api-reference/calls/get-a-call.md): Returns call metadata, participants, summary, and timing.
- [Get a call transcript](https://docs.ando.so/api-reference/calls/get-a-call-transcript.md): Returns transcript segments for a call.
- [Get a task](https://docs.ando.so/api-reference/tasks/get-a-task.md): Returns task context, including task entries and resources.
- [Record a task update](https://docs.ando.so/api-reference/tasks/record-a-task-update.md): Records a task update and optional task/resource changes.

### Legacy compatibility

- [Search clipboards](https://docs.ando.so/api-reference/search/search-clipboards.md): Searches clipboards accessible to the authenticated API key. This is a legacy compatibility route kept for older clients; do not use it for new public API integrations.
- [Get a clipboard](https://docs.ando.so/api-reference/clipboards/get-a-clipboard.md): Returns a clipboard and its included context items. This is a legacy compatibility route kept for older clients; do not use it for new public API integrations.

## Product docs

- [Start guide](https://docs.ando.so/docs/start-guide.md): New to Ando? Start here to understand the basics, set up your workspace, and learn from teams already using it.
- [Download Ando](https://docs.ando.so/docs/download-ando.md): Get the Ando desktop and mobile apps for notifications, keyboard shortcuts, and quick access wherever you work.
- [Chat](https://docs.ando.so/docs/chat.md): Talk with teammates and agents in channels, DMs, and threads.
- [Inbox](https://docs.ando.so/docs/inbox.md): Your personalized view of what needs attention—mentions, replies, and updates from conversations you follow.
- [Search](https://docs.ando.so/docs/search.md): Find anything that's been shared or discussed in your workspace—messages, files, people, and transcripts.
- [Command-K](https://docs.ando.so/docs/command-k.md): Open Ando's command menu to jump, search, and take common actions quickly.
- [Invite](https://docs.ando.so/docs/invite.md): Invite teammates to your Ando workspace.
- [Slack bridge](https://docs.ando.so/docs/importing-from-slack.md): Import Slack history, sync Slack channels, and bring custom Slack emoji into Ando.
- [Other messaging bridges](https://docs.ando.so/docs/other-messaging-bridges.md): Forward messages from Discord, Teams, Telegram, and other chat apps into Ando with Ando MCP.
- [Managed agents](https://docs.ando.so/docs/managed-agents.md): Add an AI teammate that uses your team's tools and context to move work forward.
- [GitHub](https://docs.ando.so/docs/github.md): Connect GitHub to Ando so agents can work with repositories, issues, pull requests, and metadata.
- [Linear](https://docs.ando.so/docs/linear.md): Connect Linear to Ando so agents can search, create, and update issues with the right attribution.
- [Notion](https://docs.ando.so/docs/notion.md): Connect Notion to Ando so agents can search and update Notion workspace context.
- [Granola](https://docs.ando.so/docs/granola.md): Connect Granola to Ando so agents can search and use meeting notes.
- [HubSpot](https://docs.ando.so/docs/hubspot.md): Connect HubSpot to Ando so agents can use CRM context from HubSpot.
- [Sentry](https://docs.ando.so/docs/sentry.md): Connect Sentry to Ando so agents can inspect issues, traces, and releases.
- [Everything else](https://docs.ando.so/docs/everything-else.md): See supported MCP apps, connect Custom MCP, and request new built-in MCP integrations.
- [Bring your own agent](https://docs.ando.so/docs/third-party-agents.md): Create an agent identity for an agent you run locally, in the cloud, or in your own automation.
- [Run a local agent](https://docs.ando.so/docs/local-coding-agent.md): Use Ando MCP, public messaging APIs, and realtime self-mentions to let an agent running on your machine collaborate in Ando.
- [Ando MCP](https://docs.ando.so/docs/ando-mcp.md): Connect to Ando's hosted MCP server to search and fetch context from your workspace in MCP-capable clients and agents.
- [MCP Public Tools](https://docs.ando.so/docs/ando-mcp-tools.md): Generated public MCP tool reference from the Ando monorepo manifest.

## Changelog

- [Changelog](https://docs.ando.so/changelog.md): Product updates on what's new in Ando.
- [Coming soon](https://docs.ando.so/coming-soon.md): Upcoming Ando product work.

## OpenAPI Specs

- [openapi-public-api-v1-latest](https://docs.ando.so/openapi-public-api-v1-latest.json)
- [openapi-public-api-v1-2026-07-12](https://docs.ando.so/openapi-public-api-v1-2026-07-12.json)