Save a new view of a table Visible to you alone; there is no other kind.
POST /v1/tables/{tableId}/views
Generic contract Your own version of this operation, with your tables and the fields you can read, is in
your app’s document: https://{suite}.grid82.app/{app}/v1/openapi.json, behind your credential.
Why each person gets their own .
config fills in defaults for whatever is left out: an empty filter, no sorts, nothing hidden.
Requires the records:write scope. Operation views.create. MCP tool views_create. CLI: grid82 views create (npx grid82).
Path parameters Name Type Required Description tableIdstring yes
Name Type Required Description Idempotency-Keystring no Any unique string. Sending the same key with the same request again returns the first response (marked Idempotency-Replayed: true) instead of running it twice. Reusing it for a different request is refused with 409. Kept for 24 hours. Up to 255 characters.
Request body Field Type Required Description namestring yes Up to 50 characters. configobject no
dataobject required
Show child attributes data. idstring required length: 1–64 chars
data. namestring required length: 1–120 chars
data. filterobject required
Show child attributes data.filter. idstring required length: 1–64 chars
data.filter. kindstring required
data.filter. modeenum<string> required one of: and, or
data.filter. childrenobject[] required items: ≤ 50 items
Show child attributes data.filter.children. idstring required length: 1–64 chars
data.filter.children. kindstring required
data.filter.children. fieldIdstring required pattern: ^[a-z][a-z0-9_]{0,62}$
data.filter.children. openum<string> required one 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[] required default: [] items: ≤ 10 items
Show child attributes data.sorts. fieldIdstring required pattern: ^[a-z][a-z0-9_]{0,62}$
data.sorts. descboolean required
data. groupByobject[] required default: [] items: ≤ 3 items
Show child attributes data.groupBy. fieldIdstring required pattern: ^[a-z][a-z0-9_]{0,62}$
data.groupBy. descboolean required
data. hiddenstring[] required default: []
data. rowHeightenum<string> required default: short one of: short, medium, tall, extraTall
data. searchstring required default: length: ≤ 200 chars
data. summariesRecord<string, enum<string> | null> required default: {}
data. wherestring length: ≤ 4000 chars
data. repairedobject
Show child attributes data.repaired. atstring required
data.repaired. removedstring[] required items: ≤ 50 items
data.repaired. notestring required length: ≤ 400 chars
data. tableIdstring required pattern: ^[a-z][a-z0-9_]{0,62}$
data. positioninteger required
data. createdAtstring required
data. updatedAtstring required
errorobject required
Show child attributes error. codeenum<string> required one of: not_found, forbidden, unauthenticated, validation_failed, conflict, rate_limited, payment_required, not_implemented, internal
error. messagestring required
error. detailsRecord<string, unknown>