---
title: "Which agents and teams use each visible connection"
method: GET
path: "/integrations/connections/usage"
tags: ["Integrations"]
---

# Which agents and teams use each visible connection

`GET /integrations/connections/usage`

## Request

- Base URL: `https://api.atako.ai`
- URL: `https://api.atako.ai/integrations/connections/usage`
- Auth: HTTP bearer

Same scope as GET /integrations/connections. `agentIds`: non-completed agents of the company with an active (non-expired) grant, plus the implicit default grants of `companyWide`+`defaultGranted` native connectors (`projects`, `knowledge`) for agents without an explicit grant row. `teamIds`: distinct teams of those agents.

## Response `200`

- object
  - `usage` object[]
    - `connectionId` string, uuid
    - `agentIds` string[]
    - `teamIds` string[]

## Other responses

- `401`: Missing, malformed, or invalid bearer token / API key, or revoked session (SESSION_REVOKED).

---

[API](https://skmtc.dev/atako/apis/atako-api.md) · [All operations](https://skmtc.dev/atako/apis/atako-api/llms.txt) · [OpenAPI document](https://skmtc.dev/atako/apis/atako-api/revisions/aa555c56fbd7?raw)