Integrate with the REST API: agents and data in your own systems

Everything in the console is available over a REST API, so you can use the agents inside your own website, mobile app, CRM or contact centre, and push data automatically.

1. Create a key

In the console, open API & keys, give the key a name that says where it's used (e.g. mobile-app-prod) and click Create key. Copy it now: only a fingerprint is stored, so it can't be shown again. Keep it in your server's secrets, never in a website or app that customers can download.

2. Call an agent

curl https://servicebuddy.com/api/v1/agents/auto/runs \
  -H "Authorization: Bearer $API_KEY" -H "Content-Type: application/json" \
  -d '{"messages":[{"role":"user","content":"Where is my order 1004?"}]}'

• auto lets the router pick the agent; or use a specific key such as personal-shopper.
• Add "stream": true to receive the answer token by token (server-sent events), plus product, store and return events you can render as cards.

3. Push data

curl https://servicebuddy.com/api/v1/datasets -H "Authorization: Bearer $API_KEY" \
  -F entity=product -F [email protected]

The file is auto-mapped and processed. Check progress with GET /api/v1/datasets/{id}.

Endpoints

Revoke a key

Click Revoke next to it. Calls with that key stop immediately.