---
title: "Create or update a named report view"
method: POST
path: "/api/v1/saved-views"
---

# Create or update a named report view

`POST /api/v1/saved-views`

## Request

- Base URL: `https://dirtsignal.com`
- URL: `https://dirtsignal.com/api/v1/saved-views`
- Auth: HTTP bearer

## Request body

- SavedViewInput
  - `view_id` string
  - `name` string, required
  - `definition` object, required
    - `region_slugs` string[], required
    - `cities` string[]
    - `record_types` string[]
    - `exclude_signals` string[]
    - `min_parcel_size` number, nullable
    - `max_parcel_size` number, nullable
    - `include_weak` boolean
  - `brief` object
    - `enabled` boolean
    - `frequency` 'daily' | 'weekly'
    - `email` string, email, nullable

## Response `200`

Saved view

## Other responses

- `400`: Invalid definition
- `401`: Unauthorized

---

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