Query Size and Performance
Agility applies no default page size, so an unbounded query tries to return every matching asset. How three separate defaults compound, and the request shape that avoids them.
Error Handling
How Agility API errors actually present, and how to handle them: partial failures, violation tags, retries and timeouts
Payload Patterns
The canonical request shapes for querying, creating, updating and operating on Agility assets
Performance
Decision-level performance guidance for Agility integrations: what to cache, when to batch, how much to parallelize
Reproducing Reported Numbers
Why a figure in Agility does not match the one your query returns, and how to reconstruct the calculation behind it — using velocity as the worked example.
Working with Comments
Conversations, Expressions and Mentions - the model behind comments, and how to create, reply to and read them through the API
Scope Context
The scope context - how Agility narrows the Scope hierarchy for filtering, and how Rooms embody it
Display Names
Mapping between what the UI shows and what the API calls things, using meta.v1 and the localization API
Members, Roles & Scopes
How access is granted and read through the API - default-role membership, the AssignWithRole operations, and the Project Roles read API
Rate Limiting
How Agility enforces API rate limits, how to check configured quota policies, and which endpoints expose usage metrics