---
title: "List installations for an agent"
method: GET
path: "/api/v1/agents/{agent}/agent_installations"
---

# List installations for an agent

`GET /api/v1/agents/{agent}/agent_installations`

Returns all installations belonging to the specified agent, across all kinds and
states. Use this endpoint to inspect which external services and enablement channels
an agent is connected to.

Results are scoped to the authenticated app and are returned in an unordered array.
To list installations across all agents in an app, use the top-level List
Installations endpoint instead. The caller must have app scope for the app that
owns the agent.

## Path parameters

- `agent` string, required

## Response `200`

Successful response

- InstallationListResponse — Paginated list response containing installation objects for an agent.
  - `data` Installation[], required — Array of installation objects returned for the current page.
    - `agent` string — ID of the agent that owns this installation (`agi_...`). `null` if the installation has no agent owner.
    - `config` object — Kind-specific configuration object for this installation. Shape depends on the `kind` value. `null` if the kind requires no configuration.
    - `created_at` string, date-time — When the installation was created (ISO 8601).
    - `id` string, required — Installation ID (`cin_...`).
    - `kind` string — Slug identifying the type of external service this installation connects to, e.g. `"enablement/github_app"` or `"integration/gmail"`. `null` if not set.
    - `lookup_key` string — Caller-assigned stable identifier for this installation, used to reference it in knowledge search `source_refs`. `null` if no lookup key was provided at creation time.
    - `shared_integration` string — ID of the shared org- or app-level integration bound to this installation (`int_...`). `null` if no integration has been bound.
    - `state` string — Current lifecycle state of the installation. One of `"pending"`, `"active"`, `"paused"`, or `"error"`. `"error"` indicates the installation was suspended due to a policy or compliance issue and requires attention.
    - `status_payload` object — Provider-supplied status detail for this installation, set during activation or event processing. `null` if no status has been reported.
    - `updated_at` string, date-time — When the installation record was last updated (ISO 8601).

## Other responses

- `401` — Unauthorized
- `403` — Forbidden - app scope required
- `404` — Agent not found

---

[API](https://skmtc.dev/archastro/apis/archastro-platform-api.md) · [All operations](https://skmtc.dev/archastro/apis/archastro-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/archastro/archastro-platform-api/revisions/a8772b442f86/schema)