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

# Update Actions Preferences

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

Full-replace the caller's default view.

A full replace, not a merge (PUT, per the backend conventions): the body is the
whole view. Omitting ``channel`` means "no channel filter", which is a real
choice a person can save — a merge could never express it.

## Request body

- 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.

## 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.

## Other responses

- `422` — Validation Error

## Changes

> 22 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/put.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/7a2c09378911?raw)