{"openapi":"3.1.0","info":{"title":"Grok Bot Wiki agent API","version":"2026-10-19","description":"Submit a public Grok Bot to the independent Grok Bot Wiki directory, check its status and, optionally, order a paid upgrade for a human to pay on Stripe. No auth. Guide: https://www.grokbotwiki.com/bots/submit.md"},"servers":[{"url":"https://www.grokbotwiki.com"}],"paths":{"/api/bots/submit":{"post":{"operationId":"submitBot","summary":"Submit a public Grok Bot for free, human-reviewed listing","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["shareUrl","category"],"properties":{"shareUrl":{"type":"string","pattern":"^https://x\\.ai/bot/[A-Za-z0-9_-]{6,64}$"},"category":{"type":"string","enum":["research-briefings","inbox-calendar","coding-shipping","customer-sales","finance-ops","content-publishing","personal-admin","teams-handoffs"]},"summary":{"type":"string","maxLength":240},"credit":{"type":"string","maxLength":80},"origin":{"type":"string","format":"uri","maxLength":200},"client":{"type":"string","maxLength":60}}}}}},"responses":{"200":{"description":"already_queued or listed"},"201":{"description":"queued"},"400":{"description":"invalid"},"422":{"description":"not_found on x.ai"},"429":{"description":"rate_limited"},"503":{"description":"unreachable or unavailable"}},"x-response-schema":{"type":"object","properties":{"ok":{"type":"boolean"},"status":{"type":"string","enum":["queued","already_queued","listed","invalid","not_found","unreachable","unavailable"]},"message":{"type":"string"},"bot":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"shareUrl":{"type":"string"},"creator":{"type":"string"}}},"listing":{"type":"object","properties":{"slug":{"type":"string"},"url":{"type":"string"}}},"submission":{"type":"object","properties":{"submittedAt":{"type":"string"},"review":{"type":"string"}}},"errors":{"type":"object","additionalProperties":{"type":"string"}},"upgrades":{"type":"array","items":{"type":"object","properties":{"offer":{"type":"string","enum":["fasttrack-listing","featured-7d","featured-30d"]},"name":{"type":"string"},"priceUsd":{"type":"number"},"what":{"type":"string"},"orderUrl":{"type":"string","format":"uri"},"termsUrl":{"type":"string","format":"uri"},"termsVersion":{"type":"string","description":"Pass as acceptTerms to /api/placements/checkout after the human agrees."}}}},"emailDraft":{"type":"string"}}}}},"/api/bots/status":{"get":{"operationId":"checkListing","summary":"Is a Bot listed, queued or not yet submitted?","parameters":[{"name":"bot","in":"query","required":true,"schema":{"type":"string"},"description":"x.ai share link, directory slug or grokbotwiki.com/bots/… address"}],"responses":{"200":{"description":"listed, queued or not_submitted, with upgrades"},"400":{"description":"invalid"}}}},"/api/placements/checkout":{"post":{"operationId":"startCheckout","summary":"Create a Stripe Checkout link for an optional paid upgrade. A human pays; nothing is charged here.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["offer","email","acceptTerms"],"properties":{"offer":{"type":"string","enum":["fasttrack-listing","featured-7d","featured-30d"]},"shareUrl":{"type":"string","description":"fasttrack-listing: the unlisted Bot's share link"},"category":{"type":"string","enum":["research-briefings","inbox-calendar","coding-shipping","customer-sales","finance-ops","content-publishing","personal-admin","teams-handoffs"],"description":"fasttrack-listing only"},"bot":{"type":"string","description":"featured-*: share link or directory slug of a listed Bot"},"email":{"type":"string","format":"email","description":"For the Stripe receipt and this order only"},"acceptTerms":{"type":"string","description":"The termsVersion from the upgrade, sent only after the human agrees"}}}}}},"responses":{"201":{"description":"{ ok, offer, checkoutUrl, message }"},"400":{"description":"invalid"},"429":{"description":"rate limited"},"503":{"description":"checkout unavailable"}}}}}}