operationId: someTestOperation parameters: - in: path name: pathParam schema: type: string required: true requestBody: required: true content: application/json: schema: $ref: './schemas/test-request.yaml' responses: '200': description: Successful response content: 'application/json': schema: $ref: './schemas/test-response.yaml' '400': description: Error response content: 'application/json': schema: $ref: './schemas/api-error.yaml'