Sign in

v1

latestOpenAPI 3.1.02026-07-2617501.1 MB

Take action on your user's Motive Card

post/motive_card/v1/cards/{card_id}/actions

Path parameters

card_idstring required

Specify the Public Card ID of the Motive Card (UUID), on which you want to take further action.

Request body

actionstring required

Denote the action that you are taking on this particular Motive Card. Allowed values are: <ul><li><b>freeze</b>: Freeze your Motive Card temporarily.</li><li><b>unfreeze</b>: Unfreeze you card from its existing freeze status.</li><li><b>deactivate</b>: Deactivate your existing Motive Card.</li>

reason_codestring

<b>reason_code</b> is only applicable when you are <b>deactivating</b> a card. Allowed values are as follows: <ul><li><b>10</b>: Specify this reason code if your card is lost.</li><li><b>23</b>: Specify this reason code if your card is stolen.</li><li><b>15</b>: Specify this reason code if the user is no longer at your company.</li><li><b>31</b>: Specify this reason code if the card is damaged.</li></ul>

custom_reasonstring

Specify a custom reason for deactivating the card, if you do not find any of the above reasons suitable for your case. <b>NOTE</b>: Use only for deactivating a card. This field has a limit of 255 characters.

Response

200

resultstring

Example response

{
  "result": "true"
}