Skip to Content
WalidoDocs

Getting Started

Base URLs and how to make your first request.

Base URL

Use https://api.walido.it as the base URL.

Append the base path of the API you are calling:

APIBase pathExample
MCP Connector/mcphttps://api.walido.it/mcp
Public API/api/v1https://api.walido.it/api/v1/ping

Choosing the right integration

Walido exposes one AI connector and one REST API.

If an AI client should operate Walido for you, use MCP. If your own application needs direct HTTP integration, use the Public API.

The Public API authenticates with a bearer token. MCP accepts either Public API organization keys or OAuth. See Authentication for how each credential type works.

Making your first request

Get a Public API key from the dashboard under Settings → API Keys → New key, picking a role that matches the scope you need. Then call GET /ping - it confirms the API is reachable and your key is valid:

curl https://api.walido.it/api/v1/ping \
  -H "Authorization: Bearer <your_api_key>"

Success looks like:

{ "data": { "ok": true, "now": "2026-04-23T00:00:00.000Z" } }

A 401 with { "error": { "code": "unauthorized", ... } } means the key is missing or invalid - check the header.

Responses carry X-RateLimit-* headers; see Errors & Rate Limits.

From here, continue with the Public API overview or jump straight to the Public API quickstart.

On this page