Skip to main content
POST
Create or amend a saved list view and the audience it is for: its author alone, roles, named colleagues, or the whole…

Headers

Prefer
enum<string>

Preference

Available options:
params=single-object

Body

Create or amend a saved list view and the audience it is for: its author alone, roles, named colleagues, or the whole organisation. Sharing with roles or colleagues needs admin.list_view.share_role, and each one named must be at a site the author reaches (the roles in api.list_view_roles, the people in api.list_view_recipients); the organisation needs admin.list_view.share. A view already shared by site access may be amended and kept so; the site argument is accepted for older callers and refused when used. Amending is the author's.

p_definition
string<jsonb>
required
p_list_key
string<text>
required
p_name
string<text>
required
p_description
string<text>
p_id
string<uuid>
p_role_ids
string[]
p_site_ids
string[]
p_user_ids
string[]
p_visibility
string<text>

Response

200

OK