Take action on your user's Motive Card

post

https://api.gomotive.com/motive_card/v1/cards/{card_id}/actions

Purpose: Use this endpoint to take one of the following actions on the Motive Card of your user:

Actions

Freeze: Put a temporary freeze on the Motive Card.
Unfreeze: Unfreeze a Motive Card that is already frozen.
Deactivate: Deactivate a Motive Card.

📘
NOTE
Deactivating a card is a permanent action.

You must also input reason_code and custom_reason, in the request body only when you are deactivating the Motive Card.

Path Params

card_id

string

required

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

Body Params

action

string

required

Denote the action that you are taking on this particular Motive Card. Allowed values are:

freeze: Freeze your Motive Card temporarily.
unfreeze: Unfreeze you card from its existing freeze status.
deactivate: Deactivate your existing Motive Card.

reason_code

string

reason_code is only applicable when you are deactivating a card. Allowed values are as follows:

10: Specify this reason code if your card is lost.
23: Specify this reason code if your card is stolen.
15: Specify this reason code if the user is no longer at your company.
31: Specify this reason code if the card is damaged.

custom_reason

string

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

Response

Actions

📘NOTE

200200

📘
NOTE