Overview
Discover the LLM providers, GitHub installations, and other integrations connected to your Nairi organization through the REST API. Read-only endpoints.
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). |
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.
Delete
Permanently delete a single secret from a Nairi vault by ID. Irreversible — any agent currently relying on the secret value will lose access on next run.
List LLM integrations
List the LLM provider integrations (Anthropic, OpenCode, Codex) your Nairi organization has connected. Returns the ids you assign to agents.