---
title: "Auto-fill a field by AI"
method: POST
path: "/table/{tableId}/field/{fieldId}/auto-fill"
tags: ["field"]
---

# Auto-fill a field by AI

`POST /table/{tableId}/field/{fieldId}/auto-fill`

Automatically generate suggestions for filling a specific field

## Path parameters

- `tableId` string, required
- `fieldId` string, required

## Request body

- object
  - `viewId` string — Set the view you want to fetch, default is first view. result will filter and sort by view options.
  - `filter` string — A filter object for complex query conditions based on fields, operators, and values. Use our visual query builder at https://app.teable.ai/developer/tool/query-builder to build filters.
  - `orderBy` string — An array of sort objects that specifies how the records should be ordered.
  - `groupBy` string — An array of group objects that specifies how the records should be grouped.
  - `ignoreViewQuery` union — When a viewId is specified, configure this to true will ignore the view's filter, sort, etc
    - string
    - boolean
  - `mode` 'all' | 'emptyOnly'

## Response `200`

Returns the task ID for the auto-fill process

- object
  - `taskId` string, nullable
  - `rowCount` number
  - `processedCount` number
  - `isLimited` boolean

---

[API](https://skmtc.net/teable/apis/teable-app.md) · [All operations](https://skmtc.net/teable/apis/teable-app/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/teable/teable-app/revisions/7515f3b33d79/schema)