---
title: "Take action on your user's Motive Card"
method: POST
path: "/motive_card/v1/cards/{card_id}/actions"
---

# Take action on your user's Motive Card

`POST /motive_card/v1/cards/{card_id}/actions`

## Path parameters

- `card_id` string, required

## Request body

- object
  - `action` string, 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_code` string — <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_reason` string — 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`

200

- object
  - `result` string

---

[API](https://skmtc.net/gomotive/apis/motive.md) · [All operations](https://skmtc.net/gomotive/apis/motive/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gomotive/motive/revisions/c71780e497f5/schema)