# Actions reference

Source: https://docs.settlemint.com/docs/console/essentials/actions-reference
The tabs and columns of Actions, what each action cell offers, how rows wait on each other, and how each kind of action ends.

Reference for [Actions](https://docs.settlemint.com/docs/console/essentials/actions): tabs, default and optional columns, **Execute** cell controls, waiting behaviour, permit relays, roles and terminal outcomes.

![The Actions page with the Pending, Upcoming and Completed tabs](https://docs.settlemint.com/docs/screenshots/console-actions-pending.light.en.webp)

[Screenshot] The "Pending" tab of "Actions" lists the pending actions of the active participant, one row for each action.

## Read the columns and tabs [#read-the-columns-and-tabs]

| Tab | Sort order | Default columns | Hidden by default (via **View**) |
| --- | --- | --- | --- |
| **Pending** | Soonest due first | **Action**, **Parties**, **Due**, **Execute** | **Type**, **Status**, **Waiting since** |
| **Upcoming** | Soonest open first | **Action**, **Parties**, **Opens** (**Expires** when present) | **Type**, **Status** |
| **Completed** | Most recent first | **Action**, **Outcome**, **Decision**, **Decided by**, **Decided at**, **Completed**, **Executed by** (**Expires** when present) | **Type**, **Expires** |

- **Live counts and updates**: The **Pending** tab count and sidebar badge count **Needs you** rows only, never **Waiting on others**. New rows queue behind a live pill (such as "2 new") without shifting your scroll position. If live updates drop and reconnection fails, select **Reconnect** on the "Live updates stopped" banner.
- **Conditional columns and menus**: **Amount** appears only when rows carry an amount, every row offers **View details**, and narrow screens fold secondary columns beneath the action name.
- **Search, filters and export**: Search matches the stored action name, type key (such as `ClaimYield`) or target address. The **Type** filter displays per-type counts. **Export** downloads **Export as CSV** or **Export as JSON**.
- **Bulk checker decisions**: On **Pending**, selecting multiple rows allows batch approval or rejection only when every selected row is a **Checker approval** ("Only pending checker approvals can be decided together. Deselect the other actions."). Saved views scope per tab (see [Tables](https://docs.settlemint.com/docs/concepts/operating/table-views)).

## What each cell in the action column does [#what-each-cell-in-the-action-column-does]

[Figure] The Execute column of a pending row shows a button, a decision, or no working button. Rows in the Needs you table end in the Execute column, and the row's type decides what it shows. A button named for the action, such as Claim yield or Relay permit, opens a sheet on this page or takes you to the screen that runs the operation, and it is greyed out with a reason when the Console cannot run the row. A decision in the row, such as Approve and Reject on a checker approval or Sign on a multisig approval, records or collects your decision without leaving the page. An add-on approval shows its status and a Review button that opens the proposal on this page. Some rows show no working button: a link to the screen that decides the row, or a greyed Unavailable for a type this Console version does not run. Rows that wait on other people sit in the separate Waiting on others table, which has no controls except Review on an add-on approval. Labels: The Execute column depends on the row.; Pending tab, needs you; Rows that wait on others have no controls.; Named for the action.; A named button; Claim yield, Relay permit.; Greyed out with a reason.; Approve, Reject, Sign.; A decision in the row; Checker and multisig approvals.; Sign opens a co-sign sheet.; Link or Unavailable.; No working button; Review held price.; Custody waits under; Waiting on others.

The "Execute" column of a pending row shows a named button, a decision in the row or no working button, and rows waiting on others have no controls.

| Execute cell | Row types | Behaviour |
| --- | --- | --- |
| Named action button | **Claim yield**, **Claim dividend**, **Relay permit**, **Redeem bond**, **Mature bond**, **Update KYC information**, **Approve settlement**, **Execute settlement**, **Cast vote**, **Accept invite** (**Multisig signer invite**), **Review request**, **Open request** | Opens an inline sheet or navigates to the owning screen. Disabled with a reason when unavailable. |
| **Approve** and **Reject** | **Checker approval**, **Approval request** (such as **Sign off a filing**, **Push entitlements**), **Reconciliation break resolution**, **Release a held position** | Records the decision inline without wallet verification. |
| **Reject** and reason box | Administrative changes | Prompts "Open the details to review the change before approving." **Approve** sits inside details only. See [Decide an administrative change](https://docs.settlemint.com/docs/console/essentials/actions#decide-an-administrative-change). |
| **Sign** or **View** | **Multisig approval** | Opens the co-sign sheet (**Sign** while signable, **View** read-only). |
| Screen link | **Review destination** (**Review withdrawal destination**), **Open invitations** (`Authorize invitation roles`), **Review held price** | Navigates to the owning screen to decide. |
| **Review** | **Allocation run**, offering approvals (such as **Create offering**), **Assistant finding** | Opens an inline review sheet (offering/allocation approvals offer **Approve** and **Reject** to approvers only, findings sign nothing). |
| Status text and **Review** | **Add-on approval** ("Waiting for your approval", "Can't be approved here", "Ready to run") | Opens the **Approval request** sheet to approve, run or cancel with PIN. |
| Disabled "Unavailable" | Row type unsupported in this Console version | No action available. |

Trading venue requests (**Bust a trade**, **Change desk limit**, **Change venue settings**, **Change a fee schedule**, **Cancel an order**, **Cancel orders in bulk**) are the exception to inline approval: **Approve** opens **Approve request** for PIN or code verification (see [Security](https://docs.settlemint.com/docs/console/my-account/security)) and executes immediately on the final approval, while **Reject** needs no verification.

An active button confirms only that the Console can open the flow. Authorisation runs on submission, and once confirmed, cancellation is available only while [Submissions](https://docs.settlemint.com/docs/console/essentials/submissions) offers **Undo** or **Cancel**.

## How a row waits on others [#how-a-row-waits-on-others]

- **Custody approval**: always waits in **Waiting on others** ("Signing the transaction with your custody provider" under **Waiting on**) because your custody provider approves externally.
- **Multisig approval**: moves to **Waiting on others** once you have signed or while your checker approves your co-signature, and stays in **Needs you** with **Sign** while your signature is still needed.
- **Add-on approval**: waits in **Waiting on others** until remaining approvers sign.
- **Administrative change you proposed**: hidden while pending, appearing under **Completed** once decided (except approved corporate actions awaiting execution, which stay in **Needs you** with **Open request**).

## Relay permit rows [#relay-permit-rows]

A **Relay permit** row represents a gasless ERC-20 permit signed by a holder on a token's **Permit** tab, visible to every wallet holding the token's [custodian role](https://docs.settlemint.com/docs/concepts/compliance-and-identity/roles-and-segregation-of-duties).

1. Check the permit's exact amount and deadline on the token's **Permit** tab (the relay sheet displays asset, holder and spender only).
2. Select **Relay permit** and confirm with your transaction PIN or code.

Relaying replaces the spender's allowance without moving tokens (signing a zero permit revokes it). Permits execute strictly in per-holder nonce order, so a second permit appears only after the prior nonce relays. Once any custodian relays a permit, it moves to **Completed** for all custodians. Expired unrelayed permits disappear from every tab.

## When no network serves the scope [#when-no-network-serves-the-scope]

If your selected **Network** scope has no active network, tabs and tables hide:

- **No active network in organisation**: displays "No network is active". Owners and Platform administrators see **Open Networks** to add or retry a network on [Networks](https://docs.settlemint.com/docs/console/organisation-settings/networks), while others see "Ask an organisation owner to add a network."
- **Other networks active**: displays "No network serves this scope" with **Pick network** to open the account menu's **Network** submenu (shown when multi-network is enabled with multiple active networks).

## Where else waiting work shows [#where-else-waiting-work-shows]

- **Sidebar and top bar**: the **Actions** sidebar badge and top-bar **Submissions** button count **Needs you** rows only, and the **Submissions** tray shows an **Open actions** link when items wait.
- **Asset Overview**: shows a **Needs you** card with up to six pending rows for that asset (linking via **View all** when more exist), a collapsed **Waiting on others** group, and **Upcoming** / **Completed** links. Hidden when nothing waits.

## Read the outcome, decision and due date [#read-the-outcome-decision-and-due-date]

- **Outcome** (on **Completed**): "Completed" (ran), "Expired" (lapsed, non-retryable), "Not applied" (rejected before running), or "Change failed" (approved, then failed at execution, with details explaining why).
- **Decision**: "Approved", "Approved, confirm next", "Rejected", "Expired", "Cancelled", "No second approval (approval off)", a dash (no approval required), or "... release custody next" (rejected, expired or cancelled corporate actions still holding frozen custody, offering **Release frozen custody** to the maker and **Supply management** holders).
- **Due** / **Expires**: countdown until expiry, switching to "Overdue" past deadline. Buttons stay clickable until expiry is recorded on chain, so act before **Due** passes.

## Roles and effects by row type [#roles-and-effects-by-row-type]

| Row type | Who runs it | Effect | Reference |
| --- | --- | --- | --- |
| **Claim yield** | Holder (no admin role) | Pays accrued yield once treasury is funded and approved. | [Yield and maturity](https://docs.settlemint.com/docs/console/asset-management/manage/yield-maturity) |
| **Mature bond** | Asset **Governance** (or emergency role for early maturity) | Matures the bond permanently so holders can redeem. | [Yield and maturity](https://docs.settlemint.com/docs/console/asset-management/manage/yield-maturity) |
| **Redeem bond** | Holder with positive available balance | Redeems matured position. | [Yield and maturity](https://docs.settlemint.com/docs/console/asset-management/manage/yield-maturity) |
| **Claim dividend** | Record-date entitled holder | Pays funded declared dividend. | [Cash dividend](https://docs.settlemint.com/docs/console/asset-management/manage/cash-dividend) |
| **Approve settlement** | Local flow sender | Locks sender's net leg in settlement escrow. | [Settlements](https://docs.settlemint.com/docs/console/my-assets/settlements) |
| **Execute settlement** | Any offered account once fully approved | Executes all local legs atomically. | [Settlements](https://docs.settlemint.com/docs/console/my-assets/settlements) |
| **Claim parked amount** | Wallet owning parked balance | Pays parked refund or delivery to holder's wallet. | [Settlements](https://docs.settlemint.com/docs/console/my-assets/settlements) |
| **Cast vote** | Holder with record-date voting power | Casts ballot on the token governance page. | [Votes](https://docs.settlemint.com/docs/console/my-assets/votes) |
| **Relay permit** | Asset **Custodian** wallet | Updates spender allowance on chain (moves no tokens). | [Relay permit rows](#relay-permit-rows) |
| **Checker approval** | Named checker (never the maker) | **Approve** runs the transaction, **Reject** fails it. | [Maker-checker](https://docs.settlemint.com/docs/concepts/custody-and-signing/maker-checker) |

## How each kind of action ends [#how-each-kind-of-action-ends]

- **Direct execution**: moves to **Completed** with **Completed** and **Executed by** filled.
- **Custody approval**: shows persistent "Awaiting custody approval" toast with **Open actions** until finished, then "Custody approval completed", a refusal stating nothing was sent ("Rejected by an approver", "Blocked by an approval policy", "The approval window closed", "The gas sponsorship expired"), "The custody provider reported an error" (check provider console before retrying), or "Custody approval failed".
- **Multisig signer invite**: accept screen confirms join (creator still finalises the draft).
- **Multisig approval**: co-sign sheet re-reads live signed weight against threshold each time it opens.
- **Administrative approval**: moves to **Completed** with **Decision**, **Decided by** and **Decided at** (linked to maker, checker and transaction in [Audit trail](https://docs.settlemint.com/docs/console/reporting/audit-trail)). Failed runs show "Change failed", rejected rows keep their reason in details, and expired requests leave without a row.