# 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](https://app.nairi.ai) — 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 [#why-these-endpoints-exist]

When you attach a resource to an agent via [`POST /agents/{agent_id}/resources`](/api/agent-resources/assign), three of the `entity_type` values point at integrations:

* `anthropic_integration` — the ID comes from [`GET /integrations/llm`](/api/integrations/list-llm).
* `github_repository_integration` — the ID comes from [`GET /integrations/github-repos`](/api/integrations/list-github-repos).
* `llm_model` — the value is a model slug from [`GET /models`](/api/models/list).

Without these endpoints there is no way to discover the IDs that the resource-assignment endpoint requires.

## Endpoint summary [#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 [#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/github` gives you a complete snapshot.