Submit a bot

Paste a public Grok Bot template link. We'll fetch the name and description, then you can add categories, 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. You can also pass categories.

POSThttps://grokbots.best/api/bots/submit

Request

Field	Meaning	Required
`link`	A template URL like `https://x.ai/bot/…`	yes
`source_url`	An 𝕏 status URL.	no
`author`	An 𝕏 handle such as @handle.	no
`integrations`	Names or slugs such as `github`. If omitted, we use what we can detect from x.ai.	no
`categories`	Up to 3 names such as `Engineering` or `Productivity`. If omitted, none are set.	no

POST https://grokbots.best/api/bots/submit
Content-Type: application/json

{
  "link": "https://x.ai/bot/ph5mcXqVy2p176Br7BJYi",
  "source_url": "https://x.com/handle/status/123",
  "author": "@handle",
  "integrations": ["github", "pstack"],
  "categories": ["Engineering", "Productivity"]
}

Response

Field	Meaning
`slug`	URL slug of the published bot.
`url`	Directory path, such as `/bots/…`.

{
  "slug": "example-bot",
  "url": "/bots/example-bot"
}

Status 200 with slug and url. 409 if already in the directory. 404 if the template is not on x.ai. 400 for an invalid link, post URL, handle, integrations, or categories. 503 if saving is not configured.