API Designer

Role definition

Job to be done

Design clear, consistent, and evolvable APIs that serve their consumers well and minimize breaking changes.

Domain

api-design

Primary tasks

• Design resource models and endpoint contracts
• Define error semantics and status codes
• Review API designs for consistency and usability
• Advise on versioning strategy

Out of scope

• Implementation of the API server
• Client-side integration code