---
title: "Create Grid View Template"
method: POST
path: "/api/v1/grid_view_templates"
tags: ["GridViewTemplates"]
---

# Create Grid View Template

`POST /api/v1/grid_view_templates`

## Request

- Base URL: `https://api.flexiple.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.flexiple.com/api/v1/grid_view_templates`
- Auth: HTTP bearer

## Request body

- object
  - `source_grid_view_id` string
  - `label` string
  - `table_type` 'applicants' | 'interviews' | 'tasks' | 'scheduled_interviews' | 'candidates'
  - `filters` object, nullable
  - `column_state` object
    - `visibility` object
    - `sizing` object
    - `order` string[]
    - `pinning` object
      - `left` string[]
      - `right` string[]
    - `sorting` object[]
      - `id` string, required
      - `desc` boolean
  - `height` integer
  - `custom_column_ids` unknown[]
    - unknown
  - `custom_column_template_ids` unknown[]
    - unknown

## Response `201`

Grid view template created

- object
  - `data` GridViewTemplate, required
    - `id` string, uuid, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `label` string, required
    - `table_type` 'applicants' | 'interviews' | 'tasks' | 'scheduled_interviews' | 'candidates', required
    - `column_state` object, required
      - `visibility` object, required
      - `sizing` object, required
      - `order` string[], required
      - `pinning` object, required
        - `left` string[], required
        - `right` string[], required
      - `sorting` object[], required
        - `id` string, required
        - `desc` boolean, required
    - `height` integer, nullable, required
    - `client_id` integer, required
    - `custom_column_ids` integer[], required
    - `custom_column_template_ids` integer[], required
    - `filters` object, required
      - `and` DenormalizedFilterCondition[], nullable
        - `field` string, required
        - `operator` string, required
        - `value` union, required
          - string
          - number
          - boolean
          - union[]
            - union
              - …
          - object
            - `from` number, nullable
            - `to` number, nullable
          - object
            - `value` union, required
              - …
      - `or` DenormalizedFilterCondition[], nullable
        - `field` string, required
        - `operator` string, required
        - `value` union, required
          - string
          - number
          - boolean
          - union[]
            - union
              - …
          - object
            - `from` number, nullable
            - `to` number, nullable
          - object
            - `value` union, required
              - …
  - `meta` PaginationMeta, nullable
    - `total_count` integer
    - `total_pages` integer
    - `next_page` integer, nullable
    - `prev_page` integer, nullable
    - `current_page` integer
    - `page_size` integer

## Other responses

- `401`: Authentication failed

---

[API](https://skmtc.dev/flexiple/apis/flexiple-platform-api-v1.md) - [All operations](https://skmtc.dev/flexiple/apis/flexiple-platform-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/flexiple/apis/flexiple-platform-api-v1/revisions/27e7987859f2?raw)