DELETE api/Position/Delete?positionAbbreviation={positionAbbreviation}&positionNumber={positionNumber}&positionId={positionId}

Deletes a position

Request Information

URI Parameters

NameDescriptionTypeMandatory when
positionAbbreviation

string

positionNumber

string

positionId

integer

URI Parameters are mutually exclusive (i.e. only one parameter should be specified when calling this API)

For example:

  • DELETE api/Position/Delete?postionAbbreviation=ACC
  • DELETE api/Position/Delete?postionNumber=FIN-1
  • DELETE api/Position/Delete?positionId=4

Body Parameters

None.

Response Information

Resource Description

JsonResponseModelOfString
NameDescriptionTypeMandatory when
ResponseCode

integer

ResponseMessage

string

Data

string

Response Formats

application/json, text/json

Sample:
{
  "ResponseCode": 200,
  "ResponseMessage": "Position deleted.",
  "Data": "Deleted position with position abbreviation: ACC."
}
{
  "ResponseCode": 200,
  "ResponseMessage": "Position deleted.",
  "Data": "Deleted position with position number: FIN-1."
}
{
  "ResponseCode": 200,
  "ResponseMessage": "Position deleted.",
  "Data": "Deleted position with position id: 4."
}

text/xml

Sample:
<JsonResponseModelOfstring xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/RGS.API.Models">
  <Data>Deleted position with position abbreviation: ACC.</Data>
  <ResponseCode>200</ResponseCode>
  <ResponseMessage>Position deleted.</ResponseMessage>
</JsonResponseModelOfstring>
<JsonResponseModelOfstring xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/RGS.API.Models">
  <Data>Deleted position with position number: FIN-1.</Data>
  <ResponseCode>200</ResponseCode>
  <ResponseMessage>Position deleted.</ResponseMessage>
</JsonResponseModelOfstring>
<JsonResponseModelOfstring xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/RGS.API.Models">
  <Data>Deleted position with position id: 4.</Data>
  <ResponseCode>200</ResponseCode>
  <ResponseMessage>Position deleted.</ResponseMessage>
</JsonResponseModelOfstring>

Error Response Causes

  • Invalid API credentials
  • No position exists with the given abbreviation (if positionAbbreviation parameter is provided)
  • No position exists with the given position number (if positionNumber parameter is provided)
  • No position exists with the given id (if positionId parameter is provided)