---
title: "Add iterator column"
method: POST
path: "/dataset/{handle}/iterator-column"
tags: ["data"]
---

# Add iterator column

`POST /dataset/{handle}/iterator-column`

Add an iterator column to the dataset based on current filters and order of the data.

## Path parameters

- `handle` string, required

## Request body

- IteratorRequest
  - `columnName` string
  - `filterModel` object
  - `sortModel` StructsSortEntry[]
    - `colId` string
    - `pivotFieldGroupId` string — if pivot mode is enabled it can be sorted by pivot field group id (the column headers in pivot mode)
    - `sort` string

## Response `200`

OK

- unknown

## Other responses

- `202` — Accepted
- `400` — Bad Request
- `500` — Internal Server Error

---

[API](https://skmtc.net/freshdesk/apis/gigasheet-api.md) · [All operations](https://skmtc.net/freshdesk/apis/gigasheet-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/freshdesk/gigasheet-api/versions/d1e5cbb24557/schema)