v1

latestOpenAPI 3.0.02026-08-04891301.4 MB

List installations for an agent

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.

get/api/v1/agents/{agent}/agent_installations

Path parameters

agentstring required

Agent ID (agt_...) whose installations you want to retrieve.

Response

Successful response

Example response

{
  "data": [
    {
      "agent": "agi_0aBcDeFgHiJkLmNoPqRsTu",
      "config": {},
      "created_at": "2024-01-01T00:00:00Z",
      "id": "cin_0aBcDeFgHiJkLmNoPqRsTu",
      "kind": "enablement/github_app",
      "lookup_key": "string",
      "shared_integration": "int_0aBcDeFgHiJkLmNoPqRsTu",
      "state": "active",
      "status_payload": {},
      "updated_at": "2024-01-01T00:00:00Z"
    }
  ]
}