API Response Design

Purpose

Define and enforce a universal API response contract with standardized envelopes, error codes, and pagination. Every response must be predictable regardless of success or failure.

Agent Protocol

Trigger

User request includes: api response, response envelope, response<T>, api error, exception handling, error code, api contract, pagination response, api standard.

Input Context

• Current API response format (if refactoring)
• Technology stack (language/framework)
• Error handling strategy (exceptions, result types, error codes)
• Pagination requirements