---
title: "Get Actions Preferences"
method: GET
path: "/api/v1/action-items/preferences"
tags: ["action-items"]
---

# Get Actions Preferences

`GET /api/v1/action-items/preferences`

The caller's saved default view of the Actions page; defaults if never set.

## Response `200`

Successful Response

- ActionsPreferences — The view ``/actions`` opens on for one person. Saved explicitly from the filter menu, never inferred from the last filter someone tried: a default that rewrites itself because you once checked the email chip is a surprise, and a default whose whole job is to be predictable should not surprise anyone. An explicit URL always wins over this, so a shared link still lands on what the sender saw.
  - `channel` 'voice' | 'text' | 'email'
  - `status` 'open' | 'resolved'
  - `range` '7d' | '30d' | '90d' | 'all' — How far back the Actions page looks. A closed set rather than a free string, so the client's list and the stored preference cannot drift apart. SEVEN_DAYS is the default: ACTION_ITEM_MAX_AGE is seven days, so a week is the complete set of actions the backend will create.

## Changes

> 24 revisions in range; 1 not diffed.

- **2026-09-21** `7a2c09378911` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/getanana/apis/cleon-api/changes/api/v1/action-items/preferences/get.md)

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) · [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getanana/apis/cleon-api/revisions/ae7627cd46da?raw)