Update a saved view

curl --request PATCH \
  --url https://api.select.dev/v2/saved-views/{saved_view_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-tenant-id: <x-tenant-id>' \
  --data '
{
  "name": "<string>",
  "params": "<string>",
  "icon": "<string>",
  "color": "<string>",
  "team_id": "<string>",
  "is_personal": true
}
'

import requests

url = "https://api.select.dev/v2/saved-views/{saved_view_id}"

payload = {
    "name": "<string>",
    "params": "<string>",
    "icon": "<string>",
    "color": "<string>",
    "team_id": "<string>",
    "is_personal": True
}
headers = {
    "x-tenant-id": "<x-tenant-id>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {
    'x-tenant-id': '<x-tenant-id>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: '<string>',
    params: '<string>',
    icon: '<string>',
    color: '<string>',
    team_id: '<string>',
    is_personal: true
  })
};

fetch('https://api.select.dev/v2/saved-views/{saved_view_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.select.dev/v2/saved-views/{saved_view_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'params' => '<string>',
    'icon' => '<string>',
    'color' => '<string>',
    'team_id' => '<string>',
    'is_personal' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "x-tenant-id: <x-tenant-id>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.select.dev/v2/saved-views/{saved_view_id}"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"params\": \"<string>\",\n  \"icon\": \"<string>\",\n  \"color\": \"<string>\",\n  \"team_id\": \"<string>\",\n  \"is_personal\": true\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("x-tenant-id", "<x-tenant-id>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.select.dev/v2/saved-views/{saved_view_id}")
  .header("x-tenant-id", "<x-tenant-id>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"params\": \"<string>\",\n  \"icon\": \"<string>\",\n  \"color\": \"<string>\",\n  \"team_id\": \"<string>\",\n  \"is_personal\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.select.dev/v2/saved-views/{saved_view_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["x-tenant-id"] = '<x-tenant-id>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"params\": \"<string>\",\n  \"icon\": \"<string>\",\n  \"color\": \"<string>\",\n  \"team_id\": \"<string>\",\n  \"is_personal\": true\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "etag": "<string>",
  "url": "<string>",
  "name": "<string>",
  "params": "<string>",
  "is_personal": true,
  "create_time": "<string>",
  "update_time": "<string>",
  "view_type": "<string>",
  "page": "<string>",
  "icon": "<string>",
  "color": "<string>",
  "team_id": "<string>",
  "email_address": "<string>",
  "created_by": "<string>",
  "updated_by": "<string>",
  "team": {
    "name": "<string>",
    "is_all_users": true,
    "default_member_role": "admin",
    "sso_groups": [
      {
        "sso_group_name": "<string>",
        "role": "admin"
      }
    ],
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "organization_id": "<string>",
    "permission_entity": {
      "type": "select_organization",
      "id": "<string>",
      "display_name": "<string>",
      "usage_group_details": {
        "set_name": "<string>",
        "group_name": "<string>"
      },
      "parent_id": "<string>"
    }
  }
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "retryable": true,
  "type": "about:blank",
  "details": [
    {}
  ]
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "retryable": true,
  "type": "about:blank",
  "details": [
    {}
  ]
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "retryable": true,
  "type": "about:blank",
  "details": [
    {}
  ]
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "retryable": true,
  "type": "about:blank",
  "details": [
    {}
  ]
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "retryable": true,
  "type": "about:blank",
  "details": [
    {}
  ]
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "retryable": true,
  "type": "about:blank",
  "details": [
    {}
  ]
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "retryable": true,
  "type": "about:blank",
  "details": [
    {}
  ]
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "retryable": true,
  "type": "about:blank",
  "details": [
    {}
  ]
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "retryable": true,
  "type": "about:blank",
  "details": [
    {}
  ]
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "retryable": true,
  "type": "about:blank",
  "details": [
    {}
  ]
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "retryable": true,
  "type": "about:blank",
  "details": [
    {}
  ]
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "retryable": true,
  "type": "about:blank",
  "details": [
    {}
  ]
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "retryable": true,
  "type": "about:blank",
  "details": [
    {}
  ]
}

PATCH

saved-views

{saved_view_id}

Update a saved view

curl --request PATCH \
  --url https://api.select.dev/v2/saved-views/{saved_view_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-tenant-id: <x-tenant-id>' \
  --data '
{
  "name": "<string>",
  "params": "<string>",
  "icon": "<string>",
  "color": "<string>",
  "team_id": "<string>",
  "is_personal": true
}
'

import requests

url = "https://api.select.dev/v2/saved-views/{saved_view_id}"

payload = {
    "name": "<string>",
    "params": "<string>",
    "icon": "<string>",
    "color": "<string>",
    "team_id": "<string>",
    "is_personal": True
}
headers = {
    "x-tenant-id": "<x-tenant-id>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {
    'x-tenant-id': '<x-tenant-id>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: '<string>',
    params: '<string>',
    icon: '<string>',
    color: '<string>',
    team_id: '<string>',
    is_personal: true
  })
};

fetch('https://api.select.dev/v2/saved-views/{saved_view_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.select.dev/v2/saved-views/{saved_view_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'params' => '<string>',
    'icon' => '<string>',
    'color' => '<string>',
    'team_id' => '<string>',
    'is_personal' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "x-tenant-id: <x-tenant-id>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.select.dev/v2/saved-views/{saved_view_id}"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"params\": \"<string>\",\n  \"icon\": \"<string>\",\n  \"color\": \"<string>\",\n  \"team_id\": \"<string>\",\n  \"is_personal\": true\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("x-tenant-id", "<x-tenant-id>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.select.dev/v2/saved-views/{saved_view_id}")
  .header("x-tenant-id", "<x-tenant-id>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"params\": \"<string>\",\n  \"icon\": \"<string>\",\n  \"color\": \"<string>\",\n  \"team_id\": \"<string>\",\n  \"is_personal\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.select.dev/v2/saved-views/{saved_view_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["x-tenant-id"] = '<x-tenant-id>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"params\": \"<string>\",\n  \"icon\": \"<string>\",\n  \"color\": \"<string>\",\n  \"team_id\": \"<string>\",\n  \"is_personal\": true\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "etag": "<string>",
  "url": "<string>",
  "name": "<string>",
  "params": "<string>",
  "is_personal": true,
  "create_time": "<string>",
  "update_time": "<string>",
  "view_type": "<string>",
  "page": "<string>",
  "icon": "<string>",
  "color": "<string>",
  "team_id": "<string>",
  "email_address": "<string>",
  "created_by": "<string>",
  "updated_by": "<string>",
  "team": {
    "name": "<string>",
    "is_all_users": true,
    "default_member_role": "admin",
    "sso_groups": [
      {
        "sso_group_name": "<string>",
        "role": "admin"
      }
    ],
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "organization_id": "<string>",
    "permission_entity": {
      "type": "select_organization",
      "id": "<string>",
      "display_name": "<string>",
      "usage_group_details": {
        "set_name": "<string>",
        "group_name": "<string>"
      },
      "parent_id": "<string>"
    }
  }
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "retryable": true,
  "type": "about:blank",
  "details": [
    {}
  ]
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "retryable": true,
  "type": "about:blank",
  "details": [
    {}
  ]
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "retryable": true,
  "type": "about:blank",
  "details": [
    {}
  ]
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "retryable": true,
  "type": "about:blank",
  "details": [
    {}
  ]
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "retryable": true,
  "type": "about:blank",
  "details": [
    {}
  ]
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "retryable": true,
  "type": "about:blank",
  "details": [
    {}
  ]
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "retryable": true,
  "type": "about:blank",
  "details": [
    {}
  ]
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "retryable": true,
  "type": "about:blank",
  "details": [
    {}
  ]
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "retryable": true,
  "type": "about:blank",
  "details": [
    {}
  ]
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "retryable": true,
  "type": "about:blank",
  "details": [
    {}
  ]
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "retryable": true,
  "type": "about:blank",
  "details": [
    {}
  ]
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "retryable": true,
  "type": "about:blank",
  "details": [
    {}
  ]
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "retryable": true,
  "type": "about:blank",
  "details": [
    {}
  ]
}

Authorizations

Authorization

string

header

required

Organization API key (sl_…).

Headers

If-Match

string | null

The saved view's current ETag, required to guard against a concurrent update.

x-tenant-id

string

required

The organization ID the request is scoped to.

Path Parameters

saved_view_id

string

required

Body

application/json

A merge patch: an omitted field leaves it unchanged, and null clears it. The URL a saved view represents cannot be changed after creation.

name

string | null

Display name.

params

string | null

Serialized 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 | null

Whether this is a personal view.

Response

Successful Response

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.

Show child attributes

Get Started

Endpoints

Update a saved view

Authorizations

Headers

Path Parameters

Body

Response