Read one of your saved views, as the builder

One of your own views.

GET/v1/apps/{appId}/views/{viewId}

Request

curl --request GET \
  --url 'https://studio.grid82.app/v1/apps/<appId>/views/<viewId>' \
  --header 'Authorization: Bearer <token>'

import json
import requests

url = "https://studio.grid82.app/v1/apps/<appId>/views/<viewId>"
headers = {
  "Authorization": "Bearer <token>"
}

response = requests.request("GET", url, headers=headers)
print(response.json())

const response = await fetch("https://studio.grid82.app/v1/apps/<appId>/views/<viewId>", {
  method: "GET",
  headers: {
    "Authorization": "Bearer <token>"
  },
});

const data = await response.json();
console.log(data);

<?php
$client = curl_init();

curl_setopt($client, CURLOPT_URL, "https://studio.grid82.app/v1/apps/<appId>/views/<viewId>");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer <token>",
]);
curl_setopt($client, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($client);
curl_close($client);
echo $response;

package main

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

func main() {
  req, _ := http.NewRequest("GET", "https://studio.grid82.app/v1/apps/<appId>/views/<viewId>", nil)
  req.Header.Set("Authorization", "Bearer <token>")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  data, _ := io.ReadAll(res.Body)
  fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var request = HttpRequest.newBuilder(URI.create("https://studio.grid82.app/v1/apps/<appId>/views/<viewId>"))
    .header("Authorization", "Bearer <token>")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

var response = HttpClient.newHttpClient().send(
    request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

require 'net/http'
require 'json'

uri = URI("https://studio.grid82.app/v1/apps/<appId>/views/<viewId>")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer <token>"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(request)
end

puts response.body

application/json

{
  "data": {
    "id": "<string>",
    "name": "<string>",
    "filter": {
      "id": "root",
      "kind": "group",
      "mode": "and",
      "children": []
    },
    "sorts": [],
    "groupBy": [],
    "hidden": [],
    "order": [
      "<string>"
    ],
    "rowHeight": "short",
    "search": "",
    "summaries": {},
    "where": "<string>",
    "repaired": {
      "at": "<string>",
      "removed": [
        "<string>"
      ],
      "note": "<string>"
    },
    "tableId": "<string>",
    "position": 123,
    "createdAt": "<string>",
    "updatedAt": "<string>"
  }
}

{
  "error": {
    "code": "not_found",
    "message": "<string>",
    "details": {}
  }
}

A view that is not yours is refused exactly like one that does not exist.

Requires the records:read scope. Operation apps.views.get. MCP tool apps_views_get. CLI: grid82 apps views get (npx grid82).

Path parameters

Name	Type	Required	Description
`appId`	string	yes
`viewId`	string	yes

Response

application/json

Success

dataobjectrequired

Show child attributes

data.idstringrequiredlength: 1–64 chars

data.namestringrequiredlength: 1–120 chars

data.filterobjectrequired

Show child attributes

data.filter.idstringrequiredlength: 1–64 chars

data.filter.kindstringrequired

data.filter.modeenum<string>requiredone of: and, or

data.filter.childrenobject[]requireditems: ≤ 50 items

Show child attributes

data.filter.children.idstringrequiredlength: 1–64 chars

data.filter.children.kindstringrequired

data.filter.children.fieldIdstringrequiredpattern: ^[a-z][a-z0-9_]{0,62}$

data.filter.children.openum<string>requiredone of: contains, not_contains, starts_with, ends_with, is, is_not, is_empty, is_not_empty, gt, lt, gte, lte, before, after, on_or_before, on_or_after, is_any_of, is_none_of, has_any_of, has_all_of, has_none_of, is_checked, is_unchecked

data.filter.children.valueobject

data.sortsobject[]requireddefault: []items: ≤ 10 items

Show child attributes

data.sorts.fieldIdstringrequiredpattern: ^[a-z][a-z0-9_]{0,62}$

data.sorts.descbooleanrequired

data.groupByobject[]requireddefault: []items: ≤ 3 items

Show child attributes

data.groupBy.fieldIdstringrequiredpattern: ^[a-z][a-z0-9_]{0,62}$

data.groupBy.descbooleanrequired

data.hiddenstring[]requireddefault: []

data.orderstring[]

data.rowHeightenum<string>requireddefault: shortone of: short, medium, tall, extraTall

data.searchstringrequireddefault: length: ≤ 200 chars

data.summariesRecord<string, enum<string> | null>requireddefault: {}

data.wherestringlength: ≤ 4000 chars

data.repairedobject

Show child attributes

data.repaired.atstringrequired

data.repaired.removedstring[]requireditems: ≤ 50 items

data.repaired.notestringrequiredlength: ≤ 400 chars

data.tableIdstringrequiredpattern: ^[a-z][a-z0-9_]{0,62}$

data.positionintegerrequired

data.createdAtstringrequired

data.updatedAtstringrequired

{ "data": { "id": "<string>", "name": "<string>", "filter": { "id": "root", "kind": "group", "mode": "and", "children": [] }, "sorts": [], "groupBy": [], "hidden": [], "order": [ "<string>" ], "rowHeight": "short", "search": "", "summaries": {}, "where": "<string>", "repaired": { "at": "<string>", "removed": [ "<string>" ], "note": "<string>" }, "tableId": "<string>", "position": 123, "createdAt": "<string>", "updatedAt": "<string>" } }

Read one of your saved views, as the builder

Path parameters

Response

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown