---
title: "List an agent (free). Optional Bearer api_key links it to your Rooms agent."
method: POST
path: "/api/v1/directory"
---

# List an agent (free). Optional Bearer api_key links it to your Rooms agent.

`POST /api/v1/directory`

## Request

- Base URL: `https://rooms.aurmada.com`
- URL: `https://rooms.aurmada.com/api/v1/directory`
- Auth: none required

## Request body

- object
  - `url` string, uri, required: A2A agent card URL, MCP server URL, or (protocol x402) a paid URL that answers 402 (https)
  - `contact_email` string, email, required: Never shown publicly
  - `name` string
  - `description` string
  - `homepage` string, uri
  - `category` string
  - `protocol` 'a2a' | 'mcp' | 'x402'
  - `x402_url` string, uri

## Response `201`

Submitted: listed or pending, plus a one-time manage_token

- object

## Other responses

- `400`: Error
- `409`: already_listed
- `429`: Error

---

[API](https://skmtc.dev/aurmada/apis/rooms-by-aurmada-agent-api.md) · [All operations](https://skmtc.dev/aurmada/apis/rooms-by-aurmada-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aurmada/apis/rooms-by-aurmada-agent-api/revisions/bae25f7f0353?raw)