> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useforecast.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Bots

# Bots

Bots are product objects. They are not part of the market data API.

## Collection Route

**Route:** `GET /api/v1/bots`

* `GET` is currently admin-scoped in the web API layer
* `POST` creates or upserts a bot after ownership checks

## Item Route

**Route:** `GET|PUT|DELETE /api/v1/bots/{botId}`

* `GET` reads one owned bot
* `PUT` updates through the engine upsert path
* `DELETE` removes one owned bot

## Control Route

**Route:** `POST /api/v1/bots/control?action=...&botId=...`

Current action mapping:

* `start` maps to engine `resume`
* `stop` maps to engine `pause`
* `kill` maps to engine `kill`

## Recommendation

When this becomes customer-facing, document bots as an automation API with strict ownership semantics and separate it from public market data plans.