# Create Extension Table Row

`POST /extensions-admin/{slug}/tables/{table}/rows` · Core · Extensions

Creates one row in an installed extension's own table from `values`, and answers 201 with the row as stored. The server sets `id` (an `xrw_` id), `created_by` (the caller) and both timestamps: a value sent for any of them is ignored.

The row and one `extension.table_row.created` audit event commit together; the event names the table and the row id, never a column value. A refused write that passed the rate limit writes `extension.table_row.write_refused` with its reason.

Only a signed-in operator reaches it: a plugin token, a personal access token, a service token and an end user are refused. The caller needs a project membership; an org role alone gets nothing here. The table must be one the installed version's manifest lists in `schema.user_tables`, and the caller's project role must be in the set its `min_role` names: `PROJECT_ANALYST` admits analysts, editors, authors and admins, never an auditor alone.

## Parameters

| Name | In | Required | Description |
|---|---|---|---|
| `projectSlug` | path | yes | The project's slug. Example: `"storefront"`. |
| `slug` | path | yes | The installed extension's slug. Example: `"lookout"`. |
| `table` | path | yes | A table the extension's manifest lists in `schema.user_tables`. Example: `"lk_slos"`. |

## Request body

| Field | Type | Required | Description |
|---|---|---|---|
| `values` | object | yes | Column name to value. `id`, `created_by`, `created_at` and `updated_at` are the server's: a value sent for any of them is ignored. |

## Responses

- **201**: Created

| Field | Type | Required | Description |
|---|---|---|---|
| `data` | object | yes | The row as stored. |
| `data.row` | object | yes | One row: every column of the table as stored, in the column's type. It always has `id` (the `xrw_` id the server minted), `created_by` (the author's user id), `created_at` and `updated_at`. Timestamps are ISO 8601 with an offset, to the microsecond. |
| `meta` | object | yes |  |


## Errors

| HTTP | Code | When |
|---|---|---|
| 401 | `K9O_UNAUTHENTICATED` | The caller is not signed in. |
| 403 | `K9O_FORBIDDEN` | The caller is not an operator session (`context.reason: "principal_not_admitted"`), or their project role is not in the table's `min_role` set (`context.reason: "below_min_role"`, `context.minRole`). |
| 403 | `K9O_ACCESS_DENIED` | The caller has no membership in this project; an org role alone does not count. |
| 403 | `K9O_IAM_POLICY_DENIED` | A bound IAM policy denies extensions:table_read or extensions:table_write on this extension. |
| 404 | `K9O_EXTENSION_NOT_INSTALLED` | No extension with this slug is installed on the project. |
| 403 | `K9O_EXTENSION_DISABLED` | The extension is installed but not enabled. |
| 404 | `K9O_EXTENSION_TABLE_NOT_FOUND` | The extension has no user table by this name: it is not in the manifest's `schema.user_tables`, or it does not exist. Both answer the same. |
| 409 | `K9O_STATE_CONFLICT` | The table does not have the user-table shape (`context.reason: "user_table_shape"`, `context.column`): an `id text` primary key, `created_by text NOT NULL`, and `created_at` and `updated_at` `timestamptz NOT NULL`. |
| 429 | `K9O_EXTENSION_BFF_RATE_LIMITED` | Too many calls from this caller to this extension; retry after a second. |
| 400 | `K9O_INVALID_FIELD_VALUE` | The body is not JSON, holds a key outside the operation's set (`context.unknown` names it), or a value does not fit its column. |
| 413 | `K9O_PAYLOAD_TOO_LARGE` | The body is over 256 KiB. |

## Code samples

### cURL

```bash
curl -X POST 'https://<org>.api-<region>.k9o.io/@storefront/extensions-admin/demoext/tables/<table>/rows' \
  -H 'Authorization: Bearer $K9O_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{}'
```

### fetch

```javascript
const res = await fetch('https://<org>.api-<region>.k9o.io/@storefront/extensions-admin/demoext/tables/<table>/rows', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.K9O_TOKEN}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({}),
});
const { data, meta } = await res.json();
```


Canonical page: https://docs.kilimanjaro.dev/api-playground/core/create-extension-table-row
