---
title: "Create table rows"
method: POST
path: "/tables/{table_id}/rows/"
tags: ["table-rows"]
---

# Create table rows

`POST /tables/{table_id}/rows/`

## Request

- Base URL: `https://api.getoneprofile.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getoneprofile.ai/tables/{table_id}/rows/`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Append up to 1000 empty rows to the table (one by default) and request a SINGLE row-added recompute run scoped to all of them. The row cap is enforced atomically over the whole batch, so the append is all-or-nothing. Passing after_record_id or before_record_id instead inserts exactly one row directly below or above that row, touching no other row's position. The run appears on the next active-runs poll; the response never carries a run ID, and a table with no formula columns discards the request at plan time.

## Path parameters

- `table_id` string, uuid, required

## Request body

- TableRowsCreateSchema: Request body for the row create: how many empty rows, and where. Without an anchor, rows are appended to the end of the table. With one, exactly one row is inserted directly above or below the anchor row.
  - `after_record_id` string, uuid, nullable: Insert a single row directly below this row.
  - `before_record_id` string, uuid, nullable: Insert a single row directly above this row.
  - `count` integer: Number of empty rows to append to the table.

## Response `201`

Successful Response

- TableRowsCreatedResponseSchema: The rows appended by a create, in creation order.
  - `count` integer, required
  - `rows` TableRowSchema[], required
    - `cells` object, required
    - `created_at` string, date-time, required: When the row was created.
    - `record_id` string, uuid, required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Table or anchor row not found
- `422`: Invalid request made to the API.
- `500`: Internal server error.
- `502`: Bad gateway error.
- `503`: Service unavailable.

---

[API](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile.md) · [All operations](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/llms.txt) · [OpenAPI document](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/revisions/4a6bd71e3f02?raw)