PUT api/v1/Users/{id}/UserCards

Updates details of a card's current assignment. Returns Success/Error code.

Request Information

URI Parameters

NameDescriptionTypeAdditional information
id

string

None.

Body Parameters

UpdateUserCardViewModel
NameDescriptionTypeAdditional information
UserId

The PK of a User that has a given Card assigned

globally unique identifier

None.

CardId

The PK of the Card

globally unique identifier

None.

CardActivationStartDateTime

Optional: Date and time of the card activation

date

None.

CardDeactivationStartDateTime

Optional: Date and time of the card de-activation

date

None.

CardUserFlags

Card User Flags

CardUserFlags

None.

ModifyActivationDates

Whether to modify the card activation dates. If true and both (de)activation values are null, the card is considered permanently active

boolean

None.

Request Formats

application/json, text/json

Sample:
{
  "UserId": "87e6fe9e-b974-4213-8346-b3c427fefce4",
  "CardId": "7191e3bf-5905-48a4-a1e2-43e9f08049ba",
  "CardActivationStartDateTime": "2024-03-29T15:11:04.9711072+00:00",
  "CardDeactivationStartDateTime": "2024-03-29T15:11:04.9711072+00:00",
  "CardUserFlags": 1,
  "ModifyActivationDates": true
}

application/xml, text/xml

Sample:
<UpdateUserCardViewModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/APIWebRole.Controllers">
  <CardActivationStartDateTime>2024-03-29T15:11:04.9711072+00:00</CardActivationStartDateTime>
  <CardDeactivationStartDateTime>2024-03-29T15:11:04.9711072+00:00</CardDeactivationStartDateTime>
  <CardId>7191e3bf-5905-48a4-a1e2-43e9f08049ba</CardId>
  <CardUserFlags>ActiveCardholderRecord</CardUserFlags>
  <ModifyActivationDates>true</ModifyActivationDates>
  <UserId>87e6fe9e-b974-4213-8346-b3c427fefce4</UserId>
</UpdateUserCardViewModel>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

Result
NameDescriptionTypeAdditional information
ResultCode

Represents the result code

integer

None.

Description

Represents a description of the result code

string

None.

Response Formats

application/json, text/json

Sample:
{
  "ResultCode": 1,
  "Description": "sample string 2"
}

application/xml, text/xml

Sample:
<Result xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/APIWebRole.Controllers">
  <Description>sample string 2</Description>
  <HttpStatusCode>Continue</HttpStatusCode>
  <ResultCode>1</ResultCode>
</Result>