---
title: "List org agents"
method: GET
path: "/v1/agents/org-directory"
tags: ["agents", "discovery"]
---

# List org agents

`GET /v1/agents/org-directory`

## Request

- Base URL: `https://api.1claw.co`
- URL: `https://api.1claw.co/v1/agents/org-directory`
- Auth: HTTP bearer

List agents within the caller's organization for sub-agent discovery.
Returns agents with their capabilities, enabling agent-to-agent
coordination and discovery within an org. Requires authentication.

## Query parameters

- `q` string
- `tags` string
- `page` integer
- `page_size` integer

## Response `200`

Org agent directory listing

- OrgDirectoryResponse
  - `agents` OrgDirectoryAgent[], required
    - `id` string, uuid, required
    - `name` string, required
    - `public_description` string, nullable
    - `public_tags` string[]
    - `a2a_url` string, nullable
    - `mcp_url` string, nullable
    - `intents_api_enabled` boolean, required
    - `execution_intents_enabled` boolean, required
    - `memory_enabled` boolean, required
    - `shroud_enabled` boolean, required
  - `total` integer, required
  - `page` integer, required
  - `page_size` integer, required

## Other responses

- `401`: Authentication required or invalid

---

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