Reference

API reference

Every endpoint the Apitella API exposes. Manage sources, read drift, and configure per-source rules programmatically — from a CLI, a script, or a CI pipeline.

Base URL & authentication

https://apitella-api.onrender.com/v1 — versioned so future breaking changes to the API itself land as a new /v2 instead of under you.

Every request needs an Authorization: Bearer <token> header. Two kinds of token work, and most endpoints accept either:

API key (apt_live_...) — create one from Settings → API keys in the dashboard. This is what you'd use from a CLI or CI pipeline.
Clerk session token — what the dashboard itself uses when you're signed in. Not something you'd generate by hand.

A handful of endpoints — creating API keys, and everything under Notifications — only accept a Clerk session, never an API key. Those operations are noted below ("Dashboard session only") — everything else accepts either.

Quick start

curl https://apitella-api.onrender.com/v1/sources \
  -H "Authorization: Bearer apt_live_..." \
  -H "Content-Type: application/json" \
  -d '{"type":"mcp","name":"My server","url":"https://mcp.example.com/mcp"}'

curl -X POST https://apitella-api.onrender.com/v1/sources/<id>/poll-now \
  -H "Authorization: Bearer apt_live_..."