---
title: "Submit an AI agent for listing"
method: POST
path: "/api/submit-agent"
tags: ["Agents"]
---

# Submit an AI agent for listing

`POST /api/submit-agent`

## Request

- Base URL: `https://brofindai.com`
- URL: `https://brofindai.com/api/submit-agent`
- Auth: HTTP bearer

Submit a new AI agent to the Bro Find AI /ai-agents directory. Saved immediately; appears on the site at the next build. Requires authentication.

## Request body

- object
  - `idToken` string, required: Firebase ID token
  - `agent` object, required
    - `name` string, required: Agent name
    - `url` string, uri, required: Agent website URL
    - `tagline` string: Short one-line tagline
    - `desc` string: Full description of the agent
    - `category` string: Agent category, e.g. 'Productivity', 'Voice AI Agents'. Defaults to 'Other'.
    - `pricing` 'Free' | 'Freemium' | 'Paid'
    - `logo` string, uri: Logo URL (optional)
    - `api` boolean, nullable: Tri-state: omit or send null for 'not stated'.
    - `opensource` boolean, nullable: Tri-state: omit or send null for 'not stated'.
    - `tags` string[]

## Response `200`

Agent submitted successfully

- object
  - `ok` boolean
  - `agentId` string
  - `slug` string

## Other responses

- `400`: Invalid request body
- `401`: Authentication required

---

[API](https://skmtc.dev/brofindai/apis/bro-find-ai-api.md) · [All operations](https://skmtc.dev/brofindai/apis/bro-find-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/brofindai/apis/bro-find-ai-api/revisions/4e4078821728?raw)