---
title: "Watch for new inbox notifications"
method: GET
path: "/api/v2/notifications/inbox/watch"
tags: ["Notifications"]
---

# Watch for new inbox notifications

`GET /api/v2/notifications/inbox/watch`

## Query parameters

- `targets` string
- `templates` string
- `read_status` string
- `format` 'plaintext' | 'markdown'

## Response `200`

OK

- CodersdkGetInboxNotificationResponse
  - `notification` CodersdkInboxNotification
    - `actions` CodersdkInboxNotificationAction[]
      - `label` string
      - `url` string
    - `content` string
    - `created_at` string, date-time
    - `icon` string
    - `id` string, uuid
    - `read_at` string
    - `targets` string[]
    - `template_id` string, uuid
    - `title` string
    - `user_id` string, uuid
  - `unread_count` integer

---

[API](https://skmtc.net/coder/apis/coder-api.md) · [All operations](https://skmtc.net/coder/apis/coder-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/coder/coder-api/versions/56b6e9f08540/schema)