Skip to content

Priority.vote API

The Priority.vote API lets external systems read prioritised initiatives and import / update initiatives from sources such as Jira.

This site is the contract: every endpoint is documented in the OpenAPI reference, and every integration scenario has a guide that walks through the request flow.

Where to start

  • Personal access tokens — issue, scope, and rotate the credentials your scripts use to talk to the API.
  • General integration guide — polling cadence, idempotency, error handling, and rate-limit behaviour.
  • Jira-sync walkthrough — end-to-end recipe that builds a small Jira-to-Priority.vote sync script using only documented endpoints.
  • API reference — interactive OpenAPI explorer rendered by Scalar.

Conventions

All endpoints live under https://priority.vote/api/v1/. Requests carry a Bearer token (either a session JWT or a personal access token, prefixed pv_pat_). All bodies are JSON; all timestamps are ISO 8601 in UTC.

Versioning

There is one current API version. Breaking changes are announced in the changelog before they ship; additive changes (new fields, new endpoints) ship without notice. Adapters should ignore unknown response fields.