# agent_list

List Agents

## Beschreibung

Lists the account's AI agents (every agent is scoped to one
account and visible to all its members).
Sorted alphabetically by name.

Filters (all optional):
- `active` — true to hide retired rows, false to show only retired
- `query` — case-insensitive substring match on name
- `limit` — default 50, max 250

## Zugriff

Zugriffsprofil: `gated`. Module: `none`.
Die Freigabe im Profil ersetzt keine Account-, Workspace- oder Rollenberechtigung.

## Parameter

| Name | Typ | Pflicht | Beschreibung |
| --- | --- | --- | --- |
| `account_id` | string | Ja |  |
| `active` | boolean | Nein |  |
| `query` | string | Nein |  |
| `limit` | integer | Nein |  |

## Eingabeschema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "account_id": {
      "type": "string"
    },
    "active": {
      "type": "boolean"
    },
    "query": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 50
    }
  },
  "required": [
    "account_id"
  ],
  "type": "object"
}
```

## Ausgabeschema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "agents": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "system_prompt": {
            "type": [
              "string",
              "null"
            ]
          },
          "model": {
            "type": [
              "string",
              "null"
            ]
          },
          "tools": {
            "type": "array",
            "items": {
              "type": [
                "string",
                "object"
              ]
            }
          },
          "active": {
            "type": "boolean"
          },
          "creator_role": {
            "type": "string"
          },
          "creator": {
            "type": [
              "object",
              "null"
            ]
          },
          "account_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "created_at": {
            "type": "string"
          },
          "updated_at": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "name",
          "active",
          "creator_role",
          "created_at"
        ]
      }
    }
  },
  "required": [
    "agents"
  ],
  "type": "object"
}
```