PUT v1/clients/{id}

Creates a new client or updates an existing client

Request Information

URI Parameters

NameDescriptionTypeAdditional information
id

Unique Identifier of the client to update or create.

 globally unique identifier

Required

Body Parameters

An object representing the client.

Client
NameDescriptionTypeAdditional information
Id

globally unique identifier

None.
Name

string

None.
BaseAddress

string

None.
Uri

string

None.

Request Formats

application/json, text/json

Sample: 
{
  "Id": "ce594d08-3ac3-495a-b51c-e425998466e9",
  "Name": "sample string 2",
  "BaseAddress": "sample string 3",
  "Uri": "sample string 4"
}

text/html

Sample: 
{"Id":"ce594d08-3ac3-495a-b51c-e425998466e9","Name":"sample string 2","BaseAddress":"sample string 3","Uri":"sample string 4"}

application/xml, text/xml

Sample: 
<Client xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/ITAGroup.TaxValidation.Api.Contracts.v1.Models">
  <BaseAddress>sample string 3</BaseAddress>
  <Id>ce594d08-3ac3-495a-b51c-e425998466e9</Id>
  <Name>sample string 2</Name>
  <Uri>sample string 4</Uri>
</Client>

Response Information

Resource Description

A response containing the new Client's unique id, or validation errors if the client could not be created or updated.

ClientPostResponse
NameDescriptionTypeAdditional information
Id

globally unique identifier

None.

Response Codes

  • 200 OK: Client successfully saved.
  • 400 BadRequest: Data validation failed, see the response body for more information.
  • 401 Unauthorized:
  • 500 InternalServerError:

Response Formats

application/json, text/json

Sample: 
{
  "Id": "814d9956-2b19-4463-84c7-6a6b5072da79"
}

text/html

Sample: 
{"Id":"814d9956-2b19-4463-84c7-6a6b5072da79"}

application/xml, text/xml

Sample: 
<ClientPostResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/ITAGroup.TaxValidation.Api.Contracts.v1.Responses">
  <Id>814d9956-2b19-4463-84c7-6a6b5072da79</Id>
</ClientPostResponse>