Skip to content

Providers#

The service exposes providers through two discovery endpoints. Each provider declares the capabilities it supports (the connection methods it can offer), and the registry enforces those declarations at the request edge.

No providers are registered yet

Provider adapters are added one at a time. Until the first one ships, GET /api/v1/providers returns an empty list. The planned providers and the capability model behind them are on the Roadmap.

List registered providers#

GET /api/v1/providers
{ "status": "success", "data": { "providers": [] } }

Describe a provider's capabilities#

GET /api/v1/providers/{provider}

Returns the provider's declared capabilities, or 404 unknown_provider if the name isn't registered:

{ "status": "success", "data": { "provider": "linear", "capabilities": ["SYNC", "WEBHOOK"] } }

Capability values are the registry's declared capabilities, verbatim — currently one of CSV_IMPORT, SYNC, USER_IMPORT, WEBHOOK.

Both routes require authentication — see Authentication.