# Actions

! Currently, actions only consistently work apps with a single instance.

Actions are **functions**, which you can **run at any time**.

They are **defined** on the **table**.

## Example

```js
// actions are defined on the table
kontrl.table({

  // Other settings

  actions: [
    {
      name: "Clear Cache",
      run() {
        // Clear cache here
        return "Successfully cleared cache!";
      }
    }
  ]
})
```

## Throw Errors

When you throw an error inside of an action, the message will be shown in the dashboard.

```js
// actions are defined on the table
kontrl.table({

  // Other settings

  actions: [
    {
      name: "Clear Cache",
      run() {
        throw Error("Failed to clear cache");
      }
    }
  ]
})
```