---
title: "Tenant Agents Summary"
method: GET
path: "/tenants/{id}/agents/summary"
tags: ["agents"]
---

# Tenant Agents Summary

`GET /tenants/{id}/agents/summary`

## Request

- Base URL: `https://api.instruxi.dev/api/v1/enforcer`
- URL: `https://api.instruxi.dev/api/v1/enforcer/tenants/{id}/agents/summary`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `X-API-Key`

Counts by state, owner kind and role; credentials expiring within 7 days; active agents with no use in 30 days. Needs tenant_read in that tenant.

## Path parameters

- `id` string, required

## Response `200`

OK

- InternalDeliveryHttpHandlerAgentSummaryResponse
  - `data` EnforcerV3InternalDomainAgentTenantSummary
    - `by_owner_kind` object
    - `by_role` object
    - `by_state` object
    - `credentials_expiring_7d` integer
    - `idle_30d` integer
    - `total` integer
  - `success` boolean

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found

---

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