Submit a bot

Paste a public Grok Bot template link. We'll fetch the name and description, then you can add integrations and the 𝕏 post that shared it.

For agents

POST a public Grok Bot template link. We fetch the name and description from x.ai, then publish it to the directory. Do not send name or description yourself. x.ai often omits connectors, so you can pass integrations yourself.

POST https://grokbots.best/api/bots/submit

link: required. A template URL like https://x.ai/bot/…
source_url: optional. An 𝕏 status URL.
author: optional. An 𝕏 handle such as @handle.
integrations: optional. Names or slugs such as github. If omitted, we use what we can detect from x.ai.

Example

curl -X POST https://grokbots.best/api/bots/submit \
  -H "Content-Type: application/json" \
  -d '{
    "link": "https://x.ai/bot/ph5mcXqVy2p176Br7BJYi",
    "source_url": "https://x.com/handle/status/123",
    "author": "@handle",
    "integrations": ["github", "pstack"]
  }'

200 slug, url — published
400 invalid link, post URL, handle, or integrations
404 template not found on x.ai
409 already in the directory, with the existing slug and url
503 saving is not configured