---
title: "Create view"
method: POST
path: "/public/v1/objects/{name}/views"
tags: ["Object views"]
---

# Create view

`POST /public/v1/objects/{name}/views`

Creates a saved view on an object. Requires a USER API key.

## Path parameters

- `name` string, required

## Request body

- object
  - `name` string, required
  - `type` 'TABLE' | 'KANBAN' | 'RECORD', required
  - `metadata` object
    - `grouping_field_id` number
    - `groupingColumnId` number
    - `column_order` string[]
    - `columnOrder` string[]
    - `hidden_columns` string[]
    - `hiddenColumns` string[]
    - `dialog_field_order` string[]
    - `dialogFieldOrder` string[]
    - `sticky_columns` string[]
    - `stickyColumns` string[]
    - `kanban_lane_size` 'THIN' | 'MEDIUM' | 'WIDE'
    - `kanbanLaneSize` 'THIN' | 'MEDIUM' | 'WIDE'

## Response `201`

Created view

- object
  - `ok` true, required
  - `data` object, required
    - `id` number, required
    - `name` string, required
    - `type` 'TABLE' | 'KANBAN' | 'RECORD', required
    - `is_default` boolean, required
    - `is_private` boolean, required
    - `record_type_id` number, nullable, required
    - `created_at` string, nullable, required
    - `updated_at` string, nullable, required
    - `column_order` string[]
    - `hidden_columns` string[]
    - `sticky_columns` string[]
    - `grouping_field_id` number
    - `column_ordering` object, nullable
    - `title_field_id` number
    - `display_field_ids` number[]

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found

---

[API](https://skmtc.net/getfrontline/apis/public-api.md) · [All operations](https://skmtc.net/getfrontline/apis/public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getfrontline/public-api/revisions/9d33b6aad674/schema)