---
title: "Dismiss or snooze a briefing row"
method: POST
path: "/dashboard/briefing/dismissals"
tags: ["Briefing"]
---

# Dismiss or snooze a briefing row

`POST /dashboard/briefing/dismissals`

## Request

- Base URL: `https://app.buildworkpro.com/api/v1`
- URL: `https://app.buildworkpro.com/api/v1/dashboard/briefing/dismissals`
- Auth: HTTP bearer

Hides one "Needs you today" row for the credential's user. `until` of `7d` / `30d` snoozes it; null or omitted hides it until the row's underlying state changes (a bid is re-sent, an invoice balance moves). Re-dismissing an already-dismissed row refreshes it. 404 when the entity does not exist or the credential's user cannot read it (the two are indistinguishable on purpose). Requires the read scope of the entity the row points at: invoices:read, bids:read, pay_apps:read, site_logs:read or projects:read.

## Headers

- `Idempotency-Key` string, uuid

## Request body

- object
  - `itemKey` string, required
  - `until` '7d' | '30d', nullable

## Response `201`

Dismissed

- object
  - `data` BriefingDismissal, required
    - `id` integer, required
    - `itemKey` string, required: `<category>:<entityType>:<entityId>`, as on the briefing row.
    - `dismissedUntil` union, required: Snooze end, or null until the row's state changes.
      - string, date-time
      - string
    - `createdAt` union, required
      - string, date-time
      - string
    - `updatedAt` union, required
      - string, date-time
      - string
    - `deletedAt` union, required
      - string, date-time
      - string
  - `meta` ResponseMeta, required
    - `request_id` string: Server-generated request identifier
    - `pagination` PaginationMeta
      - `cursor` string, nullable, required: Opaque cursor for the next page; null when no more results
      - `has_more` boolean, required: Whether more pages are available after this one
      - `count` integer, required: Items in this page

## Other responses

- `400`: Error
- `401`: Error
- `403`: Error
- `404`: Error
- `422`: Error

---

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