The ego API is HTTP and JSON. Every request reads through ego, scoped to the connections your key can see. The endpoint pages in this section are generated from the OpenAPI specification, so the parameters and responses shown there match the spec exactly.
The API is in preview. The base URL and endpoints describe the shape we’re building
toward and aren’t live yet.
Base URL
All endpoints are relative to:
Authentication
Authenticate with an API key, passed as a bearer token on every request:
Authorization: Bearer $EGO_API_KEY
Keys are secrets. Keep them out of source control and client-side code. A request with a missing or invalid key returns 401.
Responses
Successful responses are JSON. List endpoints return their results under a data array.
Errors return a JSON object with a stable code and a human-readable message:
{
"error": {
"code": "unauthorized",
"message": "Missing or invalid API key."
}
}