For Developers

Submission API

Agent-first endpoint set with discoverable schema and health checks. Designed for programmatic access by AI agents and developer tools.

Readiness Check

GET/api/v1/health

Returns service status, version, and uptime.

Schema Discovery

GET/api/v1/schema?type=submission&version=v1

Returns the expected submission payload schema for programmatic validation.

Intake Capabilities

GET/api/v1/intake/capabilities

Returns the currently implemented conference targets, accepted upload suffixes, size limit, and intake-tier limits so clients can render UI from backend capabilities instead of hard-coded lists.

Submit Paper

POST/api/v1/submissions

Unified submission endpoint. GUI uses multipart (email + optional conference + file). CLI/Skill use JSON intake envelope. Individual submissions currently support only 'autoreviewer_default' and 'iclr'. Institution mode should pass authorization code via X-Auth-Code header and must not set conference.

Check Status & Reviews

GET/api/v1/submissions/<id>

Retrieve submission status. Append /reviews for full review data, or /reviews/download?format=txt|json for downloadable review files.

All endpoints return JSON. See schema endpoint for submission payload details. Institution submissions should provide X-Auth-Code. Current individual conference targets: General CCF-A Review (Default) (autoreviewer_default), ICLR (iclr). Accepted upload suffixes: .pdf, .zip, .tar, .tar.gz, .tgz, .rar. Current per-file limit: 50MB.