{ "paths": { "/users/{user_id}/address": { "patch": { "operationId": "updateUserResidenceAddress", "parameters": [ { "$ref": "#/parameters/UserId" }, { "in": "body", "name": "updateResidenceAddress", "required": true, "schema": { "$ref": "#/definitions/UpdateResidenceAddress" } }, { "$ref": "#/paths/~1users~1%7Buser_id%7D~1address/get/parameters/1" } ], "summary": "Update Residence Address of an user", "responses": { "200": { "schema": { "$ref": "#/definitions/ResidenceAddress" }, "headers": { "x-correlator": { "description": "Correlation id for the different services", "type": "string" } }, "description": "OK" }, "400": { "schema": { "$ref": "#/paths/~1users~1%7Buser_id%7D~1address/get/responses/400/schema" }, "headers": { "x-correlator": { "description": "Correlation id for the different services", "type": "string" } }, "description": "Problem with the client request" } } }, "get": { "operationId": "getUserResidenceAddress", "parameters": [ { "$ref": "#/parameters/UserId" }, { "in": "header", "name": "x-correlator", "type": "string", "required": false, "description": "Correlation id for the different services" } ], "summary": "Get Residence Address of an user", "responses": { "200": { "schema": { "$ref": "#/definitions/ResidenceAddress" }, "headers": { "x-correlator": { "description": "Correlation id for the different services", "type": "string" } }, "description": "OK" }, "400": { "schema": { "allOf": [ { "type": "object", "required": [ "code" ], "properties": { "code": { "type": "string", "enum": [ "INVALID_ARGUMENT" ], "default": "INVALID_ARGUMENT", "description": "Client specified an invalid argument, request body or query param." } } }, { "type": "object", "required": [ "message" ], "properties": { "message": { "type": "string", "description": "A human readable description of what the event represent" } } } ] }, "headers": { "x-correlator": { "description": "Correlation id for the different services", "type": "string" } }, "description": "Problem with the client request" } } } } }, "basePath": "/residence-address-management/v0", "info": { "description": "...", "version": "1.6.0", "title": "Address Management" }, "schemes": [ "https" ], "produces": [ "application/json" ], "definitions": { "UpdateResidenceAddress": { "type": "object", "description": "Residence Postal Address to be updated.", "required": [ "street_address", "locality", "region", "postal_code", "country" ], "properties": { "street_address": { "type": "string" }, "additional_info": { "type": "string" }, "locality": { "type": "string" }, "region": { "type": "string" }, "postal_code": { "type": "string" }, "country": { "type": "string" } } }, "ResidenceAddress": { "type": "object", "required": [ "formatted", "street_address", "locality", "region", "postal_code", "country" ], "properties": { "formatted": { "type": "string" }, "street_address": { "type": "string" }, "additional_info": { "type": "string" }, "locality": { "type": "string" }, "region": { "type": "string" }, "postal_code": { "type": "string" }, "country": { "type": "string" } } } }, "swagger": "2.0", "consumes": [ "application/json" ], "parameters": { "UserId": { "name": "user_id", "in": "path", "required": true, "type": "string", "x-identifier": "user_id" } } }