Summary
The Pathfinder API is being updated to correctly handle scenarios where a query result exceeds the maximum size limit enforced by AWS.
Previously, when a result exceeded this limit, the API returned an empty response with a 200 OK status, making it indistinguishable from a valid empty result. With this change, the API will return a 413 Payload Too Large response along with an appropriate error message when the result exceeds the supported size.
These changes will be effective on or after 23 February 2026.
Effective Date
Monday, February 23, 2026
Details
Under the current implementation, both valid empty results and oversized results return an empty trie with a 200 OK status. This prevents consumers—such as the Journey Flow UI—from distinguishing between these two cases and displaying accurate messages.
To resolve this, oversized results will now be clearly identified using a distinct response code.
Customer Impact
- Oversized query results will now return a 413 Payload Too Large response instead of an empty 200 response.
- Consumers of the Pathfinder API must update their implementations to handle the 413 response codeappropriately.
- This change avoids ambiguity between valid empty responses and results that exceed size limits.
Impacted Resources
POST /api/v2/journey/flows/paths/query
Issue References
[GRID-5589]
Contacts
@Abby Chapin Please reply to this announcement with any questions. This helps the wider developer community benefit from the discussion. We encourage you to use this thread before contacting the designated person directly. Thank you for your understanding.