# Views, labels and saved replies

The resources that organize the inbox.

| Method | Path | Description |
| --- | --- | --- |
| `GET`, `POST` | `/v1/tags` | List or create labels ([details](/api/resources/labels-fields/)) |
| `GET`, `PATCH`, `DELETE` | `/v1/tags/{id}` | |
| `GET`, `POST` | `/v1/views` | List or create views |
| `GET`, `PATCH`, `DELETE` | `/v1/views/{id}` | |
| `GET`, `POST` | `/v1/saved-replies` | List or create saved replies |
| `GET`, `PATCH`, `DELETE` | `/v1/saved-replies/{id}` | |

## Objects

```ts
type View = {
  id: string;
  name: string;
  shared: boolean;
  position: number;
  filters: {
    status?: TicketStatus[];
    priority?: Priority[];
    assignee?: "me" | "none" | string;
    team_id?: string;
    mailbox_id?: string;
    tag?: string;
    channel?: Channel;
    q?: string;
    fields?: { key: string; op: FieldOp; value: string }[]; // custom field filters
  };
};

type SavedReply = { id: string; title: string; shortcut: string; body_html: string; created_at: string; updated_at: string };
```

## Create a view

```sh
curl https://api.opendesk.sh/v1/views \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "OD-Workspace: $WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Urgent, unassigned", "shared": true, "filters": { "status": ["open"], "priority": ["urgent"], "assignee": "none" } }'
```

List tickets in a view with `GET /v1/tickets?view_id=<id>`.

## Create a saved reply

```sh
curl https://api.opendesk.sh/v1/saved-replies \
  -H "Authorization: Bearer od_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "title": "Password reset", "shortcut": "reset", "body_html": "<p>You can reset your password from the sign-in page.</p>" }'
```

## Events

`view.*` and `saved_reply.*` (`created`, `updated`, `deleted`). Label events are listed under [Labels and custom fields](/api/resources/labels-fields/#events).

Labels, label groups and custom fields have [their own page](/api/resources/labels-fields/).