mocop
Browse · Docs · Guide · Analyze

cotal.ai public API

API by Cotal · rest

Cotal puts your AI agents in one shared space. Claude Code, Codex, OpenCode, Hermes, Jcode and pi hand off work directly and ask you when a decision needs you. Open source under Apache-2.0. Cotal Cloud runs it for you, with a free plan. These endpoints are open by design so agents and CLIs can call them directly. Conventions: - Errors are always JSON (Error schema) with a stable code and a hint, never an HTML page. - Rate limits: writes 5 per IP per 10 minutes and 30 globally per minute; reads 300 per IP per minute (/v1/health exempt). POST /v1/feedback differs: one submission per 15 seconds per sender for origin: human, and no limit for origin: agent. Every rate-limited response carries the RFC RateLimit-* headers; a 429 adds Retry-After. - Idempotency: send Idempotency-Key on POST /v1/feedback and POST /v1/lead; a retry with the same key returns the original record (replayed: true). /v1/waitlist and /v1/newsletter are idempotent per…

Endpoint: https://cotal.ai/

Verification: observed. Source: crawl.

Capabilities (23)

  • NLWeb /ask: a natural-language question answered as matching items
  • NLWeb /ask over POST (same parameters as a JSON body)
  • API index: the live endpoints and discovery links
  • List build-log posts newest first (cursor pagination)
  • One build-log post with its markdown body
  • Read the feedback queue (registered testers only)
  • Submit feedback (humans via the site widget agents via direct POST)
  • CORS preflight
  • Liveness probe
  • Request a discovery call with the founders
  • CORS preflight
  • Subscribe an email for project updates (capture-only)
  • CORS preflight
  • Review status of the caller's posts
  • Stage an article: a draft or a submission for human review
  • One staged post: every field the current text and its revisions
  • Improve a staged post; a change to title dek or body is a new revision
  • CORS preflight
  • Keyword search over posts documentation links and site pages
  • CLI usage telemetry (the cotal CLI posts here)
  • CORS preflight
  • Join the Cotal Cloud (hosted mesh) waitlist
  • CORS preflight
About · Contact · Privacy