Define one complete API contract
Write representative requests and responses for the first user task, including field types, required values, errors, pagination and version behavior. Specify the authorized caller and resource ownership rules. Format copied JSON examples for inspection, then validate them with the actual server schema and tests; a formatter is not a contract validator.