Liongard API | Metrics API Request Size Limit Update

Overview ✨

Starting 16 September 2026, Liongard will enforce a hard limit on the number of IDs or filter values that can be included in a single request to specific Metrics API endpoints.

⚠️ This is an API-only change. There are no changes to the Liongard UI, dashboards, configuration, or feature flags.

The limit applies automatically to all partners on the effective date.

What Is Changing

The following endpoints will accept no more than 100 items per applicable input:

POST /v2/metrics/evaluate
POST /v2/metrics/evaluate/systems

Endpoint	Input	Previous behavior	New behavior
`POST /v2/metrics/evaluate`	Metrics array	Unlimited	Maximum 100
`POST /v2/metrics/evaluate/systems`	Systems array	Unlimited	Maximum 100
Either endpoint	Any filter Values array, most commonly SystemID	Unlimited	Maximum 100

ℹ️ Important: Limits are applied independently to each applicable input. They are not combined into a single 100-item cap for the entire request.

For example, a single request may include:

100 Metric IDs, and
100 SystemID filter values

at the same time without exceeding the new limit.

Why Liongard Is Making This Change

Very large Metrics API requests can generate extremely large database queries. Requests containing tens of thousands of IDs can place significant load on backend infrastructure and affect platform stability.

This update is designed to prevent a single high-volume request from placing excessive load on shared resources used by other customers. It is part of Liongard's broader reliability work to improve service health and reduce the risk of high-volume API usage degrading performance for other partners.

📝 This change does not introduce a new product workflow. It enforces a request-size boundary at the API layer to protect shared infrastructure.

Who Is Affected

You are only affected if you, or an integration acting on your behalf, directly call one of the affected Metrics API endpoints with more than 100 items in one of the impacted inputs.

You may be affected if your integration sends:

More than 100 Metric IDs in the Metrics array
More than 100 System IDs in the Systems array
More than 100 values in any filter's Values array

✅ No action is required if you only use the Liongard UI or dashboards, or if your integrations already send 100 or fewer IDs or filter values per request.

Most partners will not experience any change.

What You Should Do If You Are Affected

If your integration currently sends more than 100 IDs or filter values in a single request, update it before 16 Sept 2026.

Option 1: Batch your requests

Split large lists into groups of 100 or fewer and send multiple API requests.

Example: instead of sending 500 Metric IDs in one request, send five separate requests containing 100 Metric IDs each.

Option 2: Use pagination

Both affected endpoints support pagination for retrieving larger result sets, with up to 250 rows per page.

Pagination may be the simpler approach when you need to retrieve a complete data set rather than request results for a specific large list of IDs.

ℹ️ Recommended approach: Use batching when you already know the exact IDs you need to evaluate. Use pagination when your goal is to retrieve a broader result set across multiple pages.

What Error You Will Receive

Requests that exceed the new limit will fail immediately with an HTTP 400 response. No data from that request will be processed.

The error message identifies which input exceeded the limit and how many items were received.

Example: oversized Metrics array

{   "Success": false,   "Message": "A maximum of 100 Metrics may be sent per request, received 101" }

Example: oversized filter values array

{   "Success": false,   "Message": "A maximum of 100 values may be sent per filter, received 44000 for SystemID" }

Use the returned error message to identify which input must be reduced or batched.

Frequently Asked Questions

Is the 100-item limit configurable?

No. The limit is fixed at 100 items per applicable input and is not currently configurable.

Does this affect the Liongard UI or dashboards?

No. This change applies only to direct API calls to:

POST /v2/metrics/evaluate
POST /v2/metrics/evaluate/systems

There is no UI or dashboard change.

Does this change any other API limits?

No. Existing API limits remain unchanged.

This includes:

Pagination: Maximum 250 rows per page
Per-minute request rate: 100 requests per minute per user
Metrics rate: 5,000 metrics per minute per service provider

What if I am not sure whether my integration is affected?

If you are unsure how your integration interacts with the Metrics API, contact Liongard Support with a description of how your integration makes its API calls.

Support can help determine whether the new limit applies to your integration.

Effective Date & Support 🦁

Item	Detail
Effective date	16 September 2026
Support guidance	If your integration begins returning HTTP 400 errors after the effective date and you are unsure how to update it, contact Liongard Support.

When contacting Support, include the exact error message returned by the API. The message identifies which input exceeded the limit and how many items were submitted, which helps speed up troubleshooting.