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