---
title: "List all AI actors for the caller's team."
method: GET
path: "/api/ai-actors"
tags: ["AI Actors"]
---

# List all AI actors for the caller's team.

`GET /api/ai-actors`

## Request

- Base URL: `https://app.airfocus.com`
- URL: `https://app.airfocus.com/api/ai-actors`
- Auth: HTTP bearer

Requirements:<br/>- auth-client scopes: "team:read"

## Response `200`

- AiActor[]
  - `actorType` union, required
    - 'assistant' | 'mcpServer'
    - string: An 'agent:' prefix followed by the specific agent type, e.g., 'agent:default:insights:create'
  - `createdAt` string, date-time, required
  - `id` string, uuid, required
  - `name` string, required
  - `singletonKey` string
  - `teamId` string, uuid, required
  - `updatedAt` string, date-time, required

## Other responses

- `401`: If missing authentication token.
- `403`: If authenticated client does not have the required access scopes.
- `default`: If any other error happens.

---

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