> For the complete documentation index, see [llms.txt](https://docs.buzzy.buzz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.buzzy.buzz/developing-and-extending-buzzy/buzzy-rest-api/rest-api/microapp-data-operations.md).

# MicroApp Data Operations

Use these pages for the canonical REST API reference for datatable row access.

* [row metadata and relationships](/developing-and-extending-buzzy/buzzy-rest-api/rest-api/microapp-data-operations/row-metadata-and-relationships.md) is the source of truth for system fields, `embeddingRowID`, linked-table structures, and shared row semantics
* [microappdata](/developing-and-extending-buzzy/buzzy-rest-api/rest-api/microapp-data-operations/microappdata.md) covers list/query/read-many operations
* [microappdata/row](/developing-and-extending-buzzy/buzzy-rest-api/rest-api/microapp-data-operations/microappdata-row.md) covers read-one operations
* [insertmicroapprow](/developing-and-extending-buzzy/buzzy-rest-api/rest-api/microapp-data-operations/insertmicroapprow.md), [insertmicroapprows](/developing-and-extending-buzzy/buzzy-rest-api/rest-api/microapp-data-operations/insertmicroapprows.md), [updatemicroapprow](/developing-and-extending-buzzy/buzzy-rest-api/rest-api/microapp-data-operations/updatemicroapprow.md), and [removemicroapprow](/developing-and-extending-buzzy/buzzy-rest-api/rest-api/microapp-data-operations/removemicroapprow.md) cover write operations

## Write-operation rules that apply across these endpoints

* `rowData` keys are matched against field labels, and label matching is case-sensitive.
* Unknown keys in `rowData` are ignored rather than creating new fields or changing arbitrary metadata.
* System metadata such as `_id`, `submitted`, `clientSubmitted`, `parentResourceID`, and `topLevelParentID` is not writable through `rowData`.
* The supported top-level metadata overrides are endpoint-specific and documented on each page. Today those are limited to things like `embeddingRowID`, `userID`, `viewers`, `teamViewers`, and `ignoreActionRules`.
* Some accepted parameters are permission-gated. For example, changing `userID` or moving a row to a different parent via `embeddingRowID` is only applied when the caller has the required access; otherwise the request may succeed without changing that metadata.