Skip to main content
POST
Create a saved view

Authorizations

Authorization
string
header
required

Organization API key (sl_…).

Headers

x-tenant-id
string
required

The organization ID the request is scoped to.

Body

application/json
url
string
required

The URL path this saved view represents.

name
string
required

Display name for the saved view.

params
string
required

Serialized filter/query parameters.

icon
string | null

Identifier of an icon from SELECT's icon set, e.g. Storage or CircleStar. Not validated against the set; an unrecognized value falls back to a default icon in the UI.

color
string | null

Color name, e.g. Red, Green, or Blue (not a hex code). Not validated against a fixed palette; an unrecognized value falls back to a default color in the UI.

team_id
string | null

Team to assign this view to.

is_personal
boolean
default:false

Whether this is a personal view owned by the creating user.

Response

Successful Response

id
string
required
read-only

The unique identifier of the saved view.

etag
string
required
read-only

Opaque strong ETag for this saved view. Matches the ETag response header, and changes whenever any field on the saved view changes.

url
string
required

The URL path this saved view represents.

name
string
required

Display name for the saved view.

params
string
required

Serialized filter/query parameters.

is_personal
boolean
required
read-only

Whether this is a personal view, owned only by email_address.

create_time
string
required
read-only

When the saved view was created.

update_time
string
required
read-only

When the saved view was last changed.

view_type
string
required
read-only

The ownership type: Public, Personal, or Team.

page
string
required
read-only

The page segment of the view URL.

icon
string | null

Identifier of an icon from SELECT's icon set, e.g. Storage or CircleStar. Not validated against the set; an unrecognized value falls back to a default icon in the UI.

color
string | null

Color name, e.g. Red, Green, or Blue (not a hex code). Not validated against a fixed palette; an unrecognized value falls back to a default color in the UI.

team_id
string | null

Team that owns this view, if team-scoped.

email_address
string | null

Owner email, if this is a personal view.

created_by
string | null

Email of the user who created this view.

updated_by
string | null

Email of the user who last updated this view.

team
TeamProperties · object | null

Team details, when the view is team-scoped.