# Bots (/docs/bots)



## List or search [#list-or-search]

`GET /api/v1/bots`

Query parameters: `q`, `cursor`, `limit`.

```json
{
  "data": [
    {
      "slug": "reaper",
      "name": "Reaper",
      "who": "Liam",
      "handle": "@liam_fallen",
      "job": "kill dead subs/tools",
      "templateUrl": "https://x.ai/bot/Gd-cqXG8xG_RPmKGixa73",
      "addedAt": 1756434237000
    }
  ],
  "nextCursor": null
}
```

## Get one [#get-one]

`GET /api/v1/bots/{slug}`