---
title: "Create a saved ticket view"
method: POST
path: "/saved-views"
tags: ["Saved views"]
---

# Create a saved ticket view

`POST /saved-views`

## Request

- Base URL: `https://there-there.app/api`
- URL: `https://there-there.app/api/saved-views`
- Auth: HTTP bearer

Personal views are created by default. Set `is_personal` to false to create a workspace-level view (admin only).

## Headers

- `X-Workspace-Id` integer

## Request body

- object
  - `name` string, required
  - `icon` string, nullable
  - `is_personal` boolean
  - `search` string, nullable
  - `statuses` string[], nullable
  - `assigned_to_me` boolean
  - `unassigned` boolean
  - `assigned_user_ulid` string, nullable
  - `ticket_sort_order` 'newest_activity_first' | 'oldest_first'
  - `channel_ulids` string[]
  - `tag_ulids` string[]

## Response `201`

Saved view created

- object
  - `data` SavedView
    - `id` integer
    - `ulid` string
    - `name` string
    - `slug` string
    - `icon` string, nullable
    - `is_personal` boolean
    - `search` string, nullable
    - `statuses` string[], nullable
    - `assigned_to_me` boolean
    - `unassigned` boolean
    - `assigned_user_id` integer, nullable
    - `ticket_sort_order` 'newest_activity_first' | 'oldest_first'
    - `channel_ids` integer[]
    - `tag_ids` integer[]

---

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