Create a saved view

curl -X POST http://localhost:5080/api/v1/saved_views \
  -H "authorization: Bearer $MS_JWT" \
  -H 'content-type: application/json' \
  -d '{
    "name": "Recent errors",
    "language": "sql",
    "statement": "SELECT * FROM app WHERE level = '"'"'error'"'"'",
    "time_range_secs": 3600,
    "stream": "app",
    "tags": ["operations"],
    "pinned": true
  }'

curl -X POST http://localhost:5080/api/v1/saved_views \
  -H "authorization: Bearer $MS_JWT" \
  -H 'content-type: application/json' \
  -d '{
    "name": "Recent errors",
    "language": "sql",
    "statement": "SELECT * FROM app WHERE level = '"'"'error'"'"'",
    "time_range_secs": 3600,
    "stream": "app",
    "tags": ["operations"],
    "pinned": true
  }'

POST /api/v1/saved_views

Saves a query with a relative time range. The call requires saved_views.create. Body

Field	Type	Required	Notes
`name`	string	Yes	Display name.
`language`	string	Yes	`sql` or `promql`.
`statement`	string	Yes	The query text.
`time_range_secs`	integer	Yes	Relative window, 1 through 31,622,400 seconds. A value outside the range answers `400`.
`stream`	string	No	The primary stream name.
`tags`	array of strings	No	Labels for filtering.
`pinned`	boolean	No	Shows the view first.

curl -X POST http://localhost:5080/api/v1/saved_views \
  -H "authorization: Bearer $MS_JWT" \
  -H 'content-type: application/json' \
  -d '{
    "name": "Recent errors",
    "language": "sql",
    "statement": "SELECT * FROM app WHERE level = '"'"'error'"'"'",
    "time_range_secs": 3600,
    "stream": "app",
    "tags": ["operations"],
    "pinned": true
  }'

The response is the created view, in the shape that List saved views shows.

Last modified on October 9, 2026

Overview

Authentication

Intake

Query

APM

RUM

Streams

Alerting

Correlation & Web

Platform & Administration