---
title: "Agents available to the organization, its layer on each, and the routing (org_admin)"
method: GET
path: "/api/orgs/{orgId}/agents"
tags: ["agents"]
---

# Agents available to the organization, its layer on each, and the routing (org_admin)

`GET /api/orgs/{orgId}/agents`

## Request

- Base URL: `https://api.wizbi.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.wizbi.ai/api/orgs/{orgId}/agents`
- Auth: none declared

## Path parameters

- `orgId` string, required

## Response `200`

Agents.

- OrgAgentsView
  - `agents` object[], required
    - `id` string, required
    - `name` string, required
    - `description` string, required
    - `channels` string[], required
    - `status` 'active' | 'disabled', required
    - `defaultMode` 'lean' | 'full', required
    - `org` object, nullable, required
      - `agentId` string, required
      - `orgId` string, required
      - `enabled` boolean
      - `persona` string
      - `layers` object[]
        - `id` string, required: Stable id, e.g. "group", "dm", "guest", "shared_room".
        - `text` string, required
        - `when` object
          - `modes` string[]
          - `chatTypes` string[]
          - `channels` string[]
          - `roles` string[]
          - `flag` string
      - `channelOverlays` object
        - `web` string
        - `mcp` string
        - `rest` string
        - `whatsapp` string
        - `whatsapp_web` string
        - `telegram` string
        - `sms` string
        - `slack` string
        - `teams` string
        - `email` string
        - `voice` string
        - `scheduled` string
      - `roomOverlays` object
      - `toolDeny` string[]
      - `roles` object
        - `lean` 'fast' | 'deep'
        - `full` 'fast' | 'deep'
      - `limits` object
        - `turnsPerDay` integer
        - `maxMessageChars` integer
      - `version` integer
      - `updatedAt` string, date-time
      - `updatedBy` string
      - `note` string
  - `routing` object, required
    - `orgId` string, required
    - `defaultAgent` string
    - `channels` object
      - `web` string
      - `mcp` string
      - `rest` string
      - `whatsapp` string
      - `whatsapp_web` string
      - `telegram` string
      - `sms` string
      - `slack` string
      - `teams` string
      - `email` string
      - `voice` string
      - `scheduled` string
    - `rooms` object
    - `version` integer
    - `updatedAt` string, date-time
    - `updatedBy` string
  - `flags` object, required
    - `routing` boolean, required
    - `customAgents` boolean, required
    - `deepModel` boolean, required
  - `canEdit` boolean, required

## Other responses

- `400`: Invalid request.
- `403`: Not allowed, or the feature is off for the organization.
- `404`: Unknown agent or version.
- `409`: Stale version.

---

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