generated: '2026-10-07'
method: searched
source: https://www.vaquill.ai/docs/workspace-api/concepts/rate-limits.md
docs: https://www.vaquill.ai/docs/workspace-api/concepts/rate-limits
name: Vaquill Legal Workspace API rate limits
limit_count: 18
status_on_exhaustion: 429
headers:
- Retry-After
policy_text: Budgets are **per credential**, not per IP.
limits:
- name: Poll tier per minute
  limit_text: '| Poll | 120 | 3,000 | 30,000 |'
  max: 120
  window: 1 minute
  scope: per credential
  tier: Poll
  covers: GET /v1/operations/{operationId}
  endpoint: GET /v1/operations/{operationId}
- name: Poll tier per hour
  limit_text: '| Poll | 120 | 3,000 | 30,000 |'
  max: 3000
  window: 1 hour
  scope: per credential
  tier: Poll
  covers: GET /v1/operations/{operationId}
  endpoint: GET /v1/operations/{operationId}
- name: Poll tier per day
  limit_text: '| Poll | 120 | 3,000 | 30,000 |'
  max: 30000
  window: 1 day
  scope: per credential
  tier: Poll
  covers: GET /v1/operations/{operationId}
  endpoint: GET /v1/operations/{operationId}
- name: Read tier per minute
  limit_text: '| Read | 60 | 1,200 | 15,000 |'
  max: 60
  window: 1 minute
  scope: per credential
  tier: Read
  covers: 'Metadata reads: list matters, fetch a document record'
  endpoint: null
- name: Read tier per hour
  limit_text: '| Read | 60 | 1,200 | 15,000 |'
  max: 1200
  window: 1 hour
  scope: per credential
  tier: Read
  covers: 'Metadata reads: list matters, fetch a document record'
  endpoint: null
- name: Read tier per day
  limit_text: '| Read | 60 | 1,200 | 15,000 |'
  max: 15000
  window: 1 day
  scope: per credential
  tier: Read
  covers: 'Metadata reads: list matters, fetch a document record'
  endpoint: null
- name: Write tier per minute
  limit_text: '| Write | 30 | 600 | 5,000 |'
  max: 30
  window: 1 minute
  scope: per credential
  tier: Write
  covers: 'Ordinary mutations: create a matter, update a draft'
  endpoint: null
- name: Write tier per hour
  limit_text: '| Write | 30 | 600 | 5,000 |'
  max: 600
  window: 1 hour
  scope: per credential
  tier: Write
  covers: 'Ordinary mutations: create a matter, update a draft'
  endpoint: null
- name: Write tier per day
  limit_text: '| Write | 30 | 600 | 5,000 |'
  max: 5000
  window: 1 day
  scope: per credential
  tier: Write
  covers: 'Ordinary mutations: create a matter, update a draft'
  endpoint: null
- name: Download tier per minute
  limit_text: '| Download | 20 | 300 | 3,000 |'
  max: 20
  window: 1 minute
  scope: per credential
  tier: Download
  covers: Anything that puts a file or a document's full text on the wire
  endpoint: null
- name: Download tier per hour
  limit_text: '| Download | 20 | 300 | 3,000 |'
  max: 300
  window: 1 hour
  scope: per credential
  tier: Download
  covers: Anything that puts a file or a document's full text on the wire
  endpoint: null
- name: Download tier per day
  limit_text: '| Download | 20 | 300 | 3,000 |'
  max: 3000
  window: 1 day
  scope: per credential
  tier: Download
  covers: Anything that puts a file or a document's full text on the wire
  endpoint: null
- name: Launch tier per minute
  limit_text: '| Launch | 10 | 200 | 2,000 |'
  max: 10
  window: 1 minute
  scope: per credential
  tier: Launch
  covers: 'Starting billable work: a review, a matrix run, a comparison'
  endpoint: null
- name: Launch tier per hour
  limit_text: '| Launch | 10 | 200 | 2,000 |'
  max: 200
  window: 1 hour
  scope: per credential
  tier: Launch
  covers: 'Starting billable work: a review, a matrix run, a comparison'
  endpoint: null
- name: Launch tier per day
  limit_text: '| Launch | 10 | 200 | 2,000 |'
  max: 2000
  window: 1 day
  scope: per credential
  tier: Launch
  covers: 'Starting billable work: a review, a matrix run, a comparison'
  endpoint: null
- name: Upload tier per minute
  limit_text: '| Upload | 5 | 100 | 500 |'
  max: 5
  window: 1 minute
  scope: per credential
  tier: Upload
  covers: Opening and completing upload sessions
  endpoint: null
- name: Upload tier per hour
  limit_text: '| Upload | 5 | 100 | 500 |'
  max: 100
  window: 1 hour
  scope: per credential
  tier: Upload
  covers: Opening and completing upload sessions
  endpoint: null
- name: Upload tier per day
  limit_text: '| Upload | 5 | 100 | 500 |'
  max: 500
  window: 1 day
  scope: per credential
  tier: Upload
  covers: Opening and completing upload sessions
  endpoint: null
- name: Concurrency per capability
  limit_text: '`429 concurrency-limit-reached`'
  scope: per credential per capability
  kind: concurrency
  note: too many of your jobs are already running; wait for one to finish rather than slow the request rate
note: Each operation declares a tier; twelve operations sit on the Download tier including documents.text and the nine exports. Retry-After is
  computed from the actual window.