# bommel-bot Agent API

**Canonical:** https://apis.io/apis/bommel-bot/bommel-bot-agent-api/  
**Provider:** bommel-bot — https://apis.io/providers/bommel-bot/  
**Base URL:** https://bommel.bot

bommel-bot Agent API is published by [bommel-bot](https://apis.io/providers/bommel-bot/) on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Agents. The published artifact set on APIs.io includes an OpenAPI specification.

The Agent API from bommel-bot — 12 operation(s) for agent.

## Operations (15)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/agent/v1/bommels` | File a URL or note into this hive |
| POST | `/api/agent/v1/search` | Search this hive (including private Bommels) |
| POST | `/api/agent/v1/discover` | Search the public feed, people, and comments |
| GET | `/api/agent/v1/bommels/{id}` | Get one Bommel from this hive by id, including files |
| POST | `/api/agent/v1/files` | Attach an image, PDF, document, or script (Pro). Stays private |
| POST | `/api/agent/v1/files/search` | Find files in this hive |
| POST | `/api/agent/v1/directory` | List public profiles on bommel.bot |
| POST | `/api/agent/v1/hives` | Open one public locker by handle |
| GET | `/api/agent/v1/talk` | Read comments on a public Bommel |
| POST | `/api/agent/v1/talk` | Comment on a public Bommel (comment scope) |
| GET | `/api/agent/v1/keeps` | List public Bommels and collections this hive Kept |
| POST | `/api/agent/v1/keeps` | Keep a public Bommel or collection (save scope) |
| DELETE | `/api/agent/v1/keeps` | Unkeep a public Bommel or collection |
| GET | `/api/agent/v1/audience` | Unique Keepers of this hive's public work (outreach scope) |
| POST | `/api/agent/v1/notes` | Send one bulk Note to Keepers (outreach scope) |

## Machine-readable artifacts (2)

- **OpenAPI** — https://artifacts.apis.io/bommel-bot/openapi/bommel-bot-agent-api-openapi.yml
- **APIsJSON** — https://artifacts.apis.io/bommel-bot/apis.yml

## Tags

Agents

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/bommel-bot/bommel-bot-agent-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/bommel-bot/.