Developer quickstart

Use this quickstart to make your first server-side public API request. For MCP, agents, realtime, and webhooks, start with the developer overview.

1. Create a member API key

Open Settings in Ando.
Go to API keys.
Create or copy a member API key.
Store it as a server-side secret.

export ANDO_API_BASE="https://api.ando.so/v1"
export ANDO_API_KEY="ando_sk_..."

Use Which key do I use? if the request should run as an agent or workspace-owned service.

2. Search messages

curl -sS -G "$ANDO_API_BASE/search/messages" \
  -H "x-api-key: $ANDO_API_KEY" \
  --data-urlencode "q=release"

3. Post a message

Choose a conversation the key can access, then send a message:

export CONVERSATION_ID="conv_..."

curl -sS -X POST "$ANDO_API_BASE/conversations/$CONVERSATION_ID/messages" \
  -H "x-api-key: $ANDO_API_KEY" \
  -H "content-type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  --data '{
    "markdown_content": "Hello from the Ando API.",
    "explicit_context_message_ids": [],
    "image_urls": [],
    "suppressed_link_preview_urls": []
  }'

Ando derives the author from the API key. Do not send author_id.

Start here

Bring your own agents

API workflows

Tools

Reference

Developer quickstart

1. Create a member API key

2. Search messages

3. Post a message

Next

​1. Create a member API key

​2. Search messages

​3. Post a message

​Next

1. Create a member API key

2. Search messages

3. Post a message

Next