Hi all,
We’re building a Forge dashboard gadget that reads issue status history so it can show flow time and aging. It calls two Jira Cloud REST endpoints as the user (asUser / requestJira):
POST /rest/api/3/search/jql: pages of 100 issues with a shortfieldslistPOST /rest/api/3/changelog/bulkfetch: up to 1,000 issues per request, filtered withfieldIds: ["status", "assignee", "project"]
We want to budget against the points-based app quota (65,000 points/hour for Tier 1, shared across tenants), and the rate-limiting docs list the per-object costs. What we couldn’t find is how those costs apply to these two endpoints:
- search/jql: is it 1 point per request plus 1 per issue returned? Does the number of fields requested change the cost?
- changelog/bulkfetch: what counts as an “object”?
- each issue in
issueIdsOrKeys, - each change history (changelog entry) returned, or
- each history plus its author (a user object at 2 points)?
- each issue in
- Does filtering with
fieldIdslower the cost because fewer histories come back, or is the cost set by the issues requested? - Is a request that returns a
nextPageToken(a partial page) charged differently from a full page?
What we see today on a development-environment app (api.asUser().requestJira calls from a resolver):
- Every response carries only the burst policy:
RateLimit-Policy: "jira-burst-based";q=100;w=1, plusX-RateLimit-Limit: 200. - There is no
global-app-quotaortenant-app-quotaentry inRateLimit-Policy,RateLimit, or theBeta-variants of those headers, even after a few hundred calls.
So we can’t measure the points cost ourselves. Should we expect the quota headers to show up on development installs at all, or only once an app is enrolled in the phased enforcement? Is there a way to see an app’s points usage before then?
For now we budget against a worst case of 1 per request + 1 per issue + 3 per change history, and we stop when RateLimit reports a remaining value or X-RateLimit-NearLimit: true appears. If that’s far too pessimistic, or misses something, we’d really appreciate a pointer.
Thanks!