---
title: "Agent identities the caller has run"
method: GET
path: "/api/v1/introspect/agents"
tags: ["introspect"]
---

# Agent identities the caller has run

`GET /api/v1/introspect/agents`

## Request

- Base URL: `https://api.agenticcontrolplane.com`
- URL: `https://api.agenticcontrolplane.com/api/v1/introspect/agents`
- Auth: HTTP bearer

## Query parameters

- `window` 'today' | '24h' | '7d' | '30d' | '90d'
- `scope` 'workspace'

## Response `200`

Aggregated agents.

- object
  - `ok` boolean

## Other responses

- `401`: Missing, malformed, invalid, or revoked gsk_ API key.
- `500`: Server error.

---

[API](https://skmtc.dev/agenticcontrolplane/apis/agentic-control-plane-gateway-api.md) · [All operations](https://skmtc.dev/agenticcontrolplane/apis/agentic-control-plane-gateway-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agenticcontrolplane/apis/agentic-control-plane-gateway-api/revisions/161819f3df00?raw)