PaperFoxPaperFox
API

API Changelog

Every change to the PaperFox API, newest first.

Changes that are additive under the compatibility policy — new endpoints, new optional parameters, new response fields, new enum members — ship without a version bump and are recorded here. Breaking changes would require /api/v2; there have been none.

Subscribe to this page's URL if your integration is load-bearing.

Submission creation withdrawn

POST /api/v1/submissions was briefly available and has been removed. It required the caller to be listed among the authors, which meant it only served an author scripting their own submission — not a workflow anyone actually has. The real need we expect is a chair importing submissions from another system, and that wants a different shape (submitting on behalf of authors, in batches). We would rather ship that than keep an endpoint aimed at the wrong user.

The API is read-only again. If you were relying on this endpoint, or you want programmatic submission, tell us — that's exactly the signal we're waiting for.

v1 — initial release

The first public version. Read-only.

Endpoints

  • GET /me — the key's owner, its scopes and restriction, and the conferences and roles it can reach.
  • GET /conferences, GET /conferences/{conference-slug} — conferences you hold a role in, plus tracks and phases.
  • GET /submissions, GET /submissions/{submission-slug} — scoped to your role: chairs see the conference, track chairs see their tracks, authors see their own submissions.
  • GET /submissions/{submission-slug}/reviews — full review content. Conference chairs and track chairs only.
  • GET /assignments — your own review assignments.
  • GET /registrations — conference chairs only.

Conventions

  • Bearer API keys (pfx_live_…), created under Settings → API Keys. A key acts with your live roles — never more.
  • Cursor pagination (limit + opaque cursornextCursor, hasMore).
  • Errors follow RFC 9457 (application/problem+json); branch on code.
  • Rate limits are per user, with X-RateLimit-* and RateLimit headers on every response.
  • Timestamps are RFC 3339 UTC.
  • The OpenAPI 3.1 spec is published at /api/v1/openapi.json.

On this page