---
title: "Add Databook Row"
method: POST
path: "/api/businesses/{business_id}/workbook/databook/rows"
tags: ["Data Cleaning"]
---

# Add Databook Row

`POST /api/businesses/{business_id}/workbook/databook/rows`

## Request

- Base URL: `https://api.flagpost.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.flagpost.ai/api/businesses/{business_id}/workbook/databook/rows`
- Auth: HTTP bearer

## Path parameters

- `business_id` string, required

## Query parameters

- `sheet_kind` string, nullable

## Request body

- DatabookRowCreate: Create a new row on a sheet.
  - `label` string, required
  - `category` string, nullable
  - `section` string, nullable
  - `account_id` string, uuid, nullable
  - `mapped_account_id` string, uuid, nullable
  - `statement` string, nullable
  - `row_type` 'line_item' | 'subtotal' | 'total' | 'header': Row classification inside a databook sheet.
  - `values` object
  - `sort_order` integer, nullable
  - `entity_id` string, uuid, nullable

## Response `200`

Successful Response

- DatabookRowModel: One row in a databook sheet (maps to a grid row).
  - `id` string, uuid, nullable
  - `sheet_id` string, uuid, nullable
  - `entity_id` string, uuid, nullable
  - `label` string, required
  - `category` string, nullable
  - `section` string, nullable
  - `account_id` string, uuid, nullable
  - `account_name` string, nullable
  - `mapped_account_id` string, uuid, nullable
  - `mapped_account_name` string, nullable
  - `mapping` string, nullable
  - `contributors` string[]
  - `row_type` 'line_item' | 'subtotal' | 'total' | 'header': Row classification inside a databook sheet.
  - `sort_order` integer
  - `depth` integer
  - `source_label` string, nullable
  - `built` object
  - `delta` object
  - `values` object
  - `superseded_periods` string[]
  - `values_meta` object
  - `source` object
  - `source_document_ids` string[]
  - `is_manual_edit` boolean

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/flagpost/apis/flagpost-api.md) - [All operations](https://skmtc.dev/flagpost/apis/flagpost-api/llms.txt) - [OpenAPI document](https://skmtc.dev/flagpost/apis/flagpost-api/revisions/0308cef485ca?raw)