Overview
Discover the LLM providers and GitHub installations connected to your organization.
Integrations are the third-party accounts (LLM providers, GitHub installations) your organization has connected to Nairi. They are the backing identity an agent uses when it talks to an external API.
The integrations API is read-only on the public API surface (except for renaming an LLM integration). New connections are added from the Nairi dashboard — install the GitHub App, paste an Anthropic API key, etc. — and this API exposes the IDs you need to attach those integrations to agents.
Why these endpoints exist
When you attach a resource to an agent via POST /agents/{agent_id}/resources, three of the entity_type values point at integrations:
anthropic_integration— the ID comes fromGET /integrations/llm.github_repository_integration— the ID comes fromGET /integrations/github-repos.llm_model— the value is a model slug fromGET /models.
Without these endpoints there is no way to discover the IDs that the resource-assignment endpoint requires.
Endpoint summary
| Endpoint | Purpose |
|---|---|
GET /integrations/llm | List LLM provider integrations (Anthropic, OpenCode, Codex, system-free). |
PATCH /integrations/llm/{id} | Rename an LLM integration. |
GET /integrations/github | List installed GitHub Apps (organization-level). |
GET /integrations/github-repos | List GitHub repositories connected to your org. Use these IDs as entity_id when assigning a github_repository_integration. |
GET /models | List the LLM catalog (model slugs + pricing). Use these slugs as entity_id when assigning an llm_model. |
When to use it
- Build an automated agent provisioning pipeline. Programmatically discover available LLM integrations + repos, then assemble agents without clicking through the dashboard.
- Audit which third-party accounts your org has connected. A simple
GET /integrations/llm+GET /integrations/githubgives you a complete snapshot.