@graph8/sdk 0.303.0 → 0.357.0

package/docs/api/objects.md

@@ -2,7 +2,7 @@
 
 # `g8.api.objects`: Objects
 
-24 operations (9 read, 11 write, 4 destructive).
+42 operations (14 read, 22 write, 6 destructive).
 
 18 of these also have a hand-written method (`g8.objects`), marked **★** below. Prefer the hand-written method when one exists: it unwraps the `data` envelope and takes friendlier arguments. See [../sdk-clients.md](../sdk-clients.md).
 
@@ -26,26 +26,44 @@ Exact TypeScript types for every operation on this page, and every schema they u
 | [`archiveObject`](#op-archiveobject) ★ | `DELETE /api/v1/objects/{object_slug}` | destructive | `objects:manage` | Archive Object |
 | [`archiveObjectRecord`](#op-archiveobjectrecord) ★ | `DELETE /api/v1/objects/{object_slug}/records/{record_id}` | destructive | `objects:delete` | Archive Object Record |
 | [`bulkUpdateObjectRecords`](#op-bulkupdateobjectrecords) | `PATCH /api/v1/objects/{object_slug}/records/bulk` | write | `objects:write` | Bulk Update Object Records |
+| [`commitObjectCsvImport`](#op-commitobjectcsvimport) | `POST /api/v1/objects/{object_slug}/imports/csv/drafts/{draft_id}/commit` | write | `objects:write` | Commit Object Csv Import |
 | [`createAttribute`](#op-createattribute) ★ | `POST /api/v1/objects/{object_slug}/attributes` | write | `objects:manage` | Create Attribute |
 | [`createObject`](#op-createobject) ★ | `POST /api/v1/objects` | write | `objects:manage` | Create Object |
+| [`createObjectCsvImport`](#op-createobjectcsvimport) | `POST /api/v1/objects/{object_slug}/imports/csv/drafts` | write | `objects:write` | Create Object Csv Import |
 | [`createObjectRecord`](#op-createobjectrecord) ★ | `POST /api/v1/objects/{object_slug}/records` | write | `objects:write` | Create Object Record |
 | [`createObjectRelationship`](#op-createobjectrelationship) | `POST /api/v1/objects/{object_slug}/records/{record_id}/relationships` | write | `objects:write` | Create Object Relationship |
+| [`createObjectView`](#op-createobjectview) | `POST /api/v1/objects/{object_slug}/views` | write | `objects:write` | Create Object View |
+| [`deleteObjectCsvImport`](#op-deleteobjectcsvimport) | `DELETE /api/v1/objects/{object_slug}/imports/csv/drafts/{draft_id}` | destructive | `objects:write` | Delete Object Csv Import |
 | [`deleteObjectRelationship`](#op-deleteobjectrelationship) | `DELETE /api/v1/objects/{object_slug}/records/{record_id}/relationships/{relationship_id}` | destructive | `objects:write` | Delete Object Relationship |
+| [`deleteObjectView`](#op-deleteobjectview) | `DELETE /api/v1/objects/{object_slug}/views/{view_id}` | destructive | `objects:delete` | Delete Object View |
+| [`downloadObjectCsvImportErrors`](#op-downloadobjectcsvimporterrors) | `GET /api/v1/objects/{object_slug}/imports/csv/drafts/{draft_id}/errors` | read | `objects:write` | Download Object Csv Import Errors |
+| [`exportObjectRecords`](#op-exportobjectrecords) | `POST /api/v1/objects/{object_slug}/exports` | write | `objects:export` | Export Object Records |
 | [`getObject`](#op-getobject) ★ | `GET /api/v1/objects/{object_slug}` | read | `objects:read` | Get Object |
+| [`getObjectCsvImport`](#op-getobjectcsvimport) | `GET /api/v1/objects/{object_slug}/imports/csv/drafts/{draft_id}` | read | `objects:write` | Get Object Csv Import |
 | [`getObjectRecord`](#op-getobjectrecord) ★ | `GET /api/v1/objects/{object_slug}/records/{record_id}` | read | `objects:read` | Get Object Record |
 | [`getObjectRecordChanges`](#op-getobjectrecordchanges) ★ | `GET /api/v1/objects/{object_slug}/records/{record_id}/changes` | read | `objects:read` | Get Object Record Changes |
 | [`getObjectRecordHistory`](#op-getobjectrecordhistory) ★ | `GET /api/v1/objects/{object_slug}/records/{record_id}/history` | read | `objects:read` | Get Object Record History |
 | [`getObjectRelationshipDefinitions`](#op-getobjectrelationshipdefinitions) | `GET /api/v1/objects/{object_slug}/relationships` | read | `objects:read` | Get Object Relationship Definitions |
 | [`getObjectRelationships`](#op-getobjectrelationships) | `GET /api/v1/objects/{object_slug}/records/{record_id}/relationships` | read | `objects:read` | Get Object Relationships |
+| [`inspectObjectCsvImport`](#op-inspectobjectcsvimport) | `POST /api/v1/objects/{object_slug}/imports/csv/inspect` | write | `objects:write` | Inspect Object Csv Import |
 | [`listObjectAttributes`](#op-listobjectattributes) ★ | `GET /api/v1/objects/{object_slug}/attributes` | read | `objects:read` | List Object Attributes |
+| [`listObjectCsvImports`](#op-listobjectcsvimports) | `GET /api/v1/objects/{object_slug}/imports/csv/drafts` | read | `objects:write` | List Object Csv Imports |
 | [`listObjectRecords`](#op-listobjectrecords) ★ | `GET /api/v1/objects/{object_slug}/records` | read | `objects:read` | List Object Records |
+| [`listObjectViews`](#op-listobjectviews) | `GET /api/v1/objects/{object_slug}/views` | read | `objects:read` | List Object Views |
 | [`listObjects`](#op-listobjects) ★ | `GET /api/v1/objects` | read | `objects:read` | List Objects |
 | [`mergeObjectRecords`](#op-mergeobjectrecords) | `POST /api/v1/objects/{object_slug}/records/merge` | write | `objects:write` | Merge Object Records |
+| [`previewObjectCsvImport`](#op-previewobjectcsvimport) | `POST /api/v1/objects/{object_slug}/imports/csv/drafts/{draft_id}/preview` | write | `objects:write` | Preview Object Csv Import |
+| [`queryObjectBoardGroups`](#op-queryobjectboardgroups) | `POST /api/v1/objects/{object_slug}/views/board/groups` | write | `objects:read` | Query Object Board Groups |
+| [`queryObjectBoardRecords`](#op-queryobjectboardrecords) | `POST /api/v1/objects/{object_slug}/views/board/records` | write | `objects:read` | Query Object Board Records |
 | [`restoreObjectRecord`](#op-restoreobjectrecord) ★ | `POST /api/v1/objects/{object_slug}/records/{record_id}/restore` | write | `objects:write` | Restore Object Record |
+| [`setDefaultObjectView`](#op-setdefaultobjectview) | `PUT /api/v1/objects/{object_slug}/views/default` | write | `objects:write` | Set Default Object View |
 | [`updateAttribute`](#op-updateattribute) ★ | `PATCH /api/v1/objects/{object_slug}/attributes/{attr_slug}` | write | `objects:manage` | Update Attribute |
 | [`updateObject`](#op-updateobject) ★ | `PATCH /api/v1/objects/{object_slug}` | write | `objects:manage` | Update Object |
+| [`updateObjectCsvImport`](#op-updateobjectcsvimport) | `PUT /api/v1/objects/{object_slug}/imports/csv/drafts/{draft_id}` | write | `objects:write` | Update Object Csv Import |
 | [`updateObjectRecord`](#op-updateobjectrecord) ★ | `PATCH /api/v1/objects/{object_slug}/records/{record_id}` | write | `objects:write` | Update Object Record |
+| [`updateObjectView`](#op-updateobjectview) | `PUT /api/v1/objects/{object_slug}/views/{view_id}` | write | `objects:write` | Update Object View |
 | [`upsertObjectRecord`](#op-upsertobjectrecord) ★ | `POST /api/v1/objects/{object_slug}/records/upsert` | write | `objects:write` | Upsert Object Record |
+| [`validateFormula`](#op-validateformula) | `POST /api/v1/objects/{object_slug}/attributes/formula/validate` | read | `objects:read` | Validate Formula |
 
 ---
 
@@ -61,7 +79,8 @@ Exact TypeScript types for every operation on this page, and every schema they u
 - API-key scope: `objects:manage`
 - ★ Hand-written: [`g8.objects.archiveAttribute()`](../sdk-clients.md#g8-objects-archiveattribute)
 
-Archive a custom field, retaining its values. Restore with PATCH is_archived=false.
+Archive a custom field, retaining its values. Restore with PATCH is_archived=false. Refused (409
+`formula_dependency`) while a computed field reads it, with every dependent the credential may see.
 
 **Input**
 
@@ -91,6 +110,7 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `is_system` | `boolean` | no | Whether this field is protected as a system attribute. default `false` |
 | `is_unique` | `boolean` | no | No two active records may hold the same value for this attribute. A collision is rejected with `409 duplicate_active_value`. default `false` |
 | `sort_order` | `integer` | no | Configured display order; equal values are ordered by API slug. default `0` |
+| `visible_to_role_ids` | `Array<string> \| null` | no | Role ids that may see this field; null means every role. Owners and admins always see every field. A field hidden from the caller is absent from every response. Set it with PATCH on this attribute. |
 
 **Example**
 
@@ -116,7 +136,8 @@ const result = await g8.api.objects.archiveAttribute({ path: { object_slug: "exa
 
 PREVIEW. This endpoint is deployed but gated: it returns 404 unless the hosted app platform is enabled for your organization. It is published here so the contract describes the whole surface, not so it can be called today.
 
-Archive a custom object without deleting data; restore with PATCH is_archived=false.
+Archive a custom object without deleting data; restore with PATCH is_archived=false. Refused (409
+`formula_dependency`) while a computed field elsewhere reads it, naming every dependent the credential may see.
 
 **Input**
 
@@ -259,6 +280,80 @@ const result = await g8.api.objects.bulkUpdateObjectRecords({ path: { object_slu
 
 ---
 
+<a id="op-commitobjectcsvimport"></a>
+
+### `g8.api.objects.commitObjectCsvImport(input)`
+
+**Commit Object Csv Import**
+
+- HTTP: `POST /api/v1/objects/{object_slug}/imports/csv/drafts/{draft_id}/commit`
+- operationId: `commit_object_csv_import_objects__object_slug__imports_csv_drafts__draft_id__commit_post` (also callable as `g8.api.call("commit_object_csv_import_objects__object_slug__imports_csv_drafts__draft_id__commit_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `objects:write`
+
+Commit one previewed page (at most 100 rows) in one transaction. Valid rows are imported; rows that do not validate
+are skipped and listed in skipped_rows (download them from .../errors). Send the page's revision, offset, limit,
+schema_fingerprint and every row's row_number, record_id and revision from the preview. created, updated and skipped
+count this request; resending a committed page replays its receipts as already_imported and counts nothing twice. A
+409 is never fixed by resending the same body: preview the page again.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.object_slug` | `string` | yes |  |
+| `path.draft_id` | `string (uuid)` | yes |  |
+| `body` | `ObjectImportCommit` | yes | Request body; fields below. |
+
+Body fields (`ObjectImportCommit`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.expected` | `Array<ImportRowExpectation>` | yes | min items 1, max items 100 |
+| `body.revision` | `integer` | yes | The draft revision this page was planned against min 1 |
+| `body.schema_fingerprint` | `string` | yes | pattern `^[a-f0-9]{64}$` |
+| `body.limit` | `integer` | no | default `100`, min 1, max 100 |
+| `body.offset` | `integer` | no | default `0`, min 0, max 4999 |
+
+**Returns** `ApiResponse_ObjectCsvReceipt_`: the envelope `{ data: ObjectCsvReceipt, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`ObjectCsvReceipt` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `already_imported` | `integer` | yes |  |
+| `completed` | `integer` | yes |  |
+| `created` | `integer` | yes |  |
+| `error_file_available` | `boolean` | yes |  |
+| `error_rows` | `integer` | yes |  |
+| `rows` | `Array<ImportReceiptRow>` | yes |  |
+| `skipped` | `integer` | yes |  |
+| `status` | `"draft" \| "partial" \| "completed" \| "expired"` | yes |  |
+| `total` | `integer` | yes |  |
+| `updated` | `integer` | yes |  |
+| `replayed` | `boolean` | no | default `false` |
+| `skipped_rows` | `Array<ImportSkippedRow>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.objects.commitObjectCsvImport({
+  path: {
+    object_slug: "example",
+    draft_id: "00000000-0000-0000-0000-000000000000",
+  },
+  body: {
+    expected: [{ row_number: 2 }],
+    revision: 1,
+    schema_fingerprint: "example",
+  },
+});
+```
+
+---
+
 <a id="op-createattribute"></a>
 
 ### `g8.api.objects.createAttribute(input)`
@@ -274,7 +369,9 @@ const result = await g8.api.objects.bulkUpdateObjectRecords({ path: { object_slu
 
 PREVIEW. This endpoint is deployed but gated: it returns 404 unless the hosted app platform is enabled for your organization. It is published here so the contract describes the whole surface, not so it can be called today.
 
-Create a typed CRM field. Requires objects:manage and current Admin access.
+Create a typed CRM field. Requires objects:manage and current Admin access. A computed field is checked against
+the schema the credential may see (an admin key included): a field it cannot see or an object it cannot read is
+`unknown_field` / `unknown_relationship` (422), exactly as validate answers.
 
 **Input**
 
@@ -320,6 +417,7 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `is_system` | `boolean` | no | Whether this field is protected as a system attribute. default `false` |
 | `is_unique` | `boolean` | no | No two active records may hold the same value for this attribute. A collision is rejected with `409 duplicate_active_value`. default `false` |
 | `sort_order` | `integer` | no | Configured display order; equal values are ordered by API slug. default `0` |
+| `visible_to_role_ids` | `Array<string> \| null` | no | Role ids that may see this field; null means every role. Owners and admins always see every field. A field hidden from the caller is absent from every response. Set it with PATCH on this attribute. |
 
 **Example**
 
@@ -392,6 +490,73 @@ const result = await g8.api.objects.createObject({
 
 ---
 
+<a id="op-createobjectcsvimport"></a>
+
+### `g8.api.objects.createObjectCsvImport(input)`
+
+**Create Object Csv Import**
+
+- HTTP: `POST /api/v1/objects/{object_slug}/imports/csv/drafts`
+- operationId: `create_object_csv_import_objects__object_slug__imports_csv_drafts_post` (also callable as `g8.api.call("create_object_csv_import_objects__object_slug__imports_csv_drafts_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `objects:write`
+
+Upload a CSV once with its column mapping (header to field slug), mode create or upsert, and matching field for upsert.
+The file is stored with the import for 30 days or until every row is imported. Writes no records.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.object_slug` | `string` | yes |  |
+| `body` | `ObjectImportCreate` | yes | Request body; fields below. |
+
+Body fields (`ObjectImportCreate`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.csv` | `string` | yes | min length 1, max length 2000000 |
+| `body.filename` | `string` | yes | min length 1, max length 255 |
+| `body.mapping` | `Record<string, string>` | no |  |
+| `body.matching_attribute` | `string \| null` | no | max length 100 |
+| `body.mode` | `"create" \| "upsert"` | no | default `"create"` |
+
+**Returns** `ApiResponse_ObjectImportDetail_`: the envelope `{ data: ObjectImportDetail, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`ObjectImportDetail` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `completed` | `integer` | yes |  |
+| `created_at` | `string (date-time)` | yes |  |
+| `error_rows` | `integer` | yes |  |
+| `expires_at` | `string (date-time)` | yes |  |
+| `filename` | `string` | yes |  |
+| `headers` | `Array<string>` | yes |  |
+| `id` | `string (uuid)` | yes |  |
+| `owner_id` | `string` | yes |  |
+| `owner_type` | `"user" \| "api"` | yes |  |
+| `revision` | `integer` | yes |  |
+| `setup` | `ObjectImportSetup` | yes |  |
+| `source_available` | `boolean` | yes |  |
+| `status` | `"draft" \| "partial" \| "completed" \| "expired"` | yes |  |
+| `total` | `integer` | yes |  |
+| `updated_at` | `string (date-time)` | yes |  |
+| `sample` | `Array<Array<string>>` | no | First rows of the file while it is still stored |
+
+**Example**
+
+```ts
+const result = await g8.api.objects.createObjectCsvImport({
+  path: { object_slug: "example" },
+  body: { csv: "example", filename: "Example" },
+});
+```
+
+---
+
 <a id="op-createobjectrecord"></a>
 
 ### `g8.api.objects.createObjectRecord(input)`
@@ -518,6 +683,104 @@ const result = await g8.api.objects.createObjectRelationship({
 
 ---
 
+<a id="op-createobjectview"></a>
+
+### `g8.api.objects.createObjectView(input)`
+
+**Create Object View**
+
+- HTTP: `POST /api/v1/objects/{object_slug}/views`
+- operationId: `create_object_view_objects__object_slug__views_post` (also callable as `g8.api.call("create_object_view_objects__object_slug__views_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `objects:write`
+
+Save a private or shared view owned by this credential, without impersonating a human.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.object_slug` | `string` | yes |  |
+| `body` | `ObjectViewCreate` | yes | Request body; fields below. |
+
+Body fields (`ObjectViewCreate`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.title` | `string` | yes | min length 1, max length 120 |
+| `body.state` | `ObjectViewState` | no |  |
+| `body.visibility` | `Visibility` | no | default `"private"` |
+
+**Returns** `ApiResponse_SavedViewResponse_`: the envelope `{ data: SavedViewResponse, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`SavedViewResponse` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `context_key` | `string \| null` | yes |  |
+| `created_at` | `string (date-time) \| null` | yes |  |
+| `created_by` | `string` | yes |  |
+| `description` | `string \| null` | yes |  |
+| `entity_type` | `EntityType` | yes |  |
+| `id` | `string (uuid)` | yes |  |
+| `is_default` | `boolean` | yes |  |
+| `is_owner` | `boolean` | yes |  |
+| `is_reusable` | `boolean` | yes |  |
+| `state` | `Record<string, unknown>` | yes |  |
+| `title` | `string` | yes |  |
+| `updated_at` | `string (date-time) \| null` | yes |  |
+| `visibility` | `Visibility` | yes |  |
+
+**Example**
+
+```ts
+const result = await g8.api.objects.createObjectView({ path: { object_slug: "example" }, body: { title: "Example" } });
+```
+
+---
+
+<a id="op-deleteobjectcsvimport"></a>
+
+### `g8.api.objects.deleteObjectCsvImport(input)`
+
+**Delete Object Csv Import**
+
+- HTTP: `DELETE /api/v1/objects/{object_slug}/imports/csv/drafts/{draft_id}`
+- operationId: `delete_object_csv_import_objects__object_slug__imports_csv_drafts__draft_id__delete` (also callable as `g8.api.call("delete_object_csv_import_objects__object_slug__imports_csv_drafts__draft_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `objects:write`
+
+Delete the stored file and setup. Records already imported, their history and import receipts are kept.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.object_slug` | `string` | yes |  |
+| `path.draft_id` | `string (uuid)` | yes |  |
+| `query.revision` | `integer` | yes |  |
+
+**Returns** `ApiResponse_dict_`: the envelope `{ data: Record<string, unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.objects.deleteObjectCsvImport({
+  path: {
+    object_slug: "example",
+    draft_id: "00000000-0000-0000-0000-000000000000",
+  },
+  query: { revision: 1 },
+});
+```
+
+---
+
 <a id="op-deleteobjectrelationship"></a>
 
 ### `g8.api.objects.deleteObjectRelationship(input)`
@@ -589,6 +852,120 @@ const result = await g8.api.objects.deleteObjectRelationship({
 
 ---
 
+<a id="op-deleteobjectview"></a>
+
+### `g8.api.objects.deleteObjectView(input)`
+
+**Delete Object View**
+
+- HTTP: `DELETE /api/v1/objects/{object_slug}/views/{view_id}`
+- operationId: `delete_object_view_objects__object_slug__views__view_id__delete` (also callable as `g8.api.call("delete_object_view_objects__object_slug__views__view_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `objects:delete`
+
+Delete a view owned by this credential. Does not delete records.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.object_slug` | `string` | yes |  |
+| `path.view_id` | `string (uuid)` | yes |  |
+
+**Returns** `ApiResponse_NoneType_`: the envelope `{ data: null, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.objects.deleteObjectView({
+  path: {
+    object_slug: "example",
+    view_id: "00000000-0000-0000-0000-000000000000",
+  },
+});
+```
+
+---
+
+<a id="op-downloadobjectcsvimporterrors"></a>
+
+### `g8.api.objects.downloadObjectCsvImportErrors(input)`
+
+**Download Object Csv Import Errors**
+
+- HTTP: `GET /api/v1/objects/{object_slug}/imports/csv/drafts/{draft_id}/errors`
+- operationId: `download_object_csv_import_errors_objects__object_slug__imports_csv_drafts__draft_id__errors_get` (also callable as `g8.api.call("download_object_csv_import_errors_objects__object_slug__imports_csv_drafts__draft_id__errors_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `objects:write`
+
+Download skipped and rejected rows as CSV. While the file is stored: the original columns plus row_number, column
+and error, ready to fix and re-upload (cells are spreadsheet-safe). Afterwards: row_number, column and code only,
+never values. Needs the same read grant as an export.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.object_slug` | `string` | yes |  |
+| `path.draft_id` | `string (uuid)` | yes |  |
+
+**Returns** `unknown`.
+
+**Example**
+
+```ts
+const result = await g8.api.objects.downloadObjectCsvImportErrors({
+  path: {
+    object_slug: "example",
+    draft_id: "00000000-0000-0000-0000-000000000000",
+  },
+});
+```
+
+---
+
+<a id="op-exportobjectrecords"></a>
+
+### `g8.api.objects.exportObjectRecords(input)`
+
+**Export Object Records**
+
+- HTTP: `POST /api/v1/objects/{object_slug}/exports`
+- operationId: `export_object_records_objects__object_slug__exports_post` (also callable as `g8.api.call("export_object_records_objects__object_slug__exports_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `objects:export`
+
+Download every matching native custom record of a view (filters, search, sort, columns, archived scope) as CSV or
+typed JSON. Explicit objects:read and objects:export scopes and the key's read grant are required and rechecked before
+delivery. Maximum 256 MB and 120 seconds; no partial files. CSV is spreadsheet-safe. Not a workspace backup.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.object_slug` | `string` | yes |  |
+| `body` | `ObjectExportRequest` | yes | Request body; fields below. |
+
+Body fields (`ObjectExportRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.format` | `"csv" \| "json"` | no | default `"csv"` |
+| `body.state` | `ObjectViewState` | no |  |
+
+**Returns** `string (binary)`.
+
+**Example**
+
+```ts
+const result = await g8.api.objects.exportObjectRecords({ path: { object_slug: "example" }, body: {} });
+```
+
+---
+
 <a id="op-getobject"></a>
 
 ### `g8.api.objects.getObject(input)`
@@ -637,6 +1014,64 @@ const result = await g8.api.objects.getObject({ path: { object_slug: "example" }
 
 ---
 
+<a id="op-getobjectcsvimport"></a>
+
+### `g8.api.objects.getObjectCsvImport(input)`
+
+**Get Object Csv Import**
+
+- HTTP: `GET /api/v1/objects/{object_slug}/imports/csv/drafts/{draft_id}`
+- operationId: `get_object_csv_import_objects__object_slug__imports_csv_drafts__draft_id__get` (also callable as `g8.api.call("get_object_csv_import_objects__object_slug__imports_csv_drafts__draft_id__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `objects:write`
+
+Read one of this credential's imports: setup, headers, progress, status and up to five sample rows while the file is stored.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.object_slug` | `string` | yes |  |
+| `path.draft_id` | `string (uuid)` | yes |  |
+
+**Returns** `ApiResponse_ObjectImportDetail_`: the envelope `{ data: ObjectImportDetail, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`ObjectImportDetail` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `completed` | `integer` | yes |  |
+| `created_at` | `string (date-time)` | yes |  |
+| `error_rows` | `integer` | yes |  |
+| `expires_at` | `string (date-time)` | yes |  |
+| `filename` | `string` | yes |  |
+| `headers` | `Array<string>` | yes |  |
+| `id` | `string (uuid)` | yes |  |
+| `owner_id` | `string` | yes |  |
+| `owner_type` | `"user" \| "api"` | yes |  |
+| `revision` | `integer` | yes |  |
+| `setup` | `ObjectImportSetup` | yes |  |
+| `source_available` | `boolean` | yes |  |
+| `status` | `"draft" \| "partial" \| "completed" \| "expired"` | yes |  |
+| `total` | `integer` | yes |  |
+| `updated_at` | `string (date-time)` | yes |  |
+| `sample` | `Array<Array<string>>` | no | First rows of the file while it is still stored |
+
+**Example**
+
+```ts
+const result = await g8.api.objects.getObjectCsvImport({
+  path: {
+    object_slug: "example",
+    draft_id: "00000000-0000-0000-0000-000000000000",
+  },
+});
+```
+
+---
+
 <a id="op-getobjectrecord"></a>
 
 ### `g8.api.objects.getObjectRecord(input)`
@@ -869,16 +1304,62 @@ const result = await g8.api.objects.getObjectRelationships({ path: { object_slug
 
 ---
 
-<a id="op-listobjectattributes"></a>
+<a id="op-inspectobjectcsvimport"></a>
 
-### `g8.api.objects.listObjectAttributes(input)`
+### `g8.api.objects.inspectObjectCsvImport(input)`
 
-**List Object Attributes**
+**Inspect Object Csv Import**
 
-- HTTP: `GET /api/v1/objects/{object_slug}/attributes`
-- operationId: `list_object_attributes_objects__object_slug__attributes_get` (also callable as `g8.api.call("list_object_attributes_objects__object_slug__attributes_get", input)`)
-- Tier: `read`: reads data; safe to call and to retry
-- API-key scope: `objects:read`
+- HTTP: `POST /api/v1/objects/{object_slug}/imports/csv/inspect`
+- operationId: `inspect_object_csv_import_objects__object_slug__imports_csv_inspect_post` (also callable as `g8.api.call("inspect_object_csv_import_objects__object_slug__imports_csv_inspect_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `objects:write`
+
+Read a CSV's headers, five sample rows and row count. Nothing is stored or written. Maximum 2 MB, 5000 rows, 200 columns.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.object_slug` | `string` | yes |  |
+| `body` | `ObjectCsvInspect` | yes | Request body; fields below. |
+
+Body fields (`ObjectCsvInspect`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.csv` | `string` | yes | min length 1, max length 2000000 |
+
+**Returns** `ApiResponse_ObjectCsvInspection_`: the envelope `{ data: ObjectCsvInspection, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`ObjectCsvInspection` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `headers` | `Array<string>` | yes |  |
+| `sample` | `Array<Array<string>>` | yes |  |
+| `total` | `integer` | yes |  |
+
+**Example**
+
+```ts
+const result = await g8.api.objects.inspectObjectCsvImport({ path: { object_slug: "example" }, body: { csv: "example" } });
+```
+
+---
+
+<a id="op-listobjectattributes"></a>
+
+### `g8.api.objects.listObjectAttributes(input)`
+
+**List Object Attributes**
+
+- HTTP: `GET /api/v1/objects/{object_slug}/attributes`
+- operationId: `list_object_attributes_objects__object_slug__attributes_get` (also callable as `g8.api.call("list_object_attributes_objects__object_slug__attributes_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `objects:read`
 - Lifecycle: `preview` (may not be enabled for every org yet)
 - ★ Hand-written: [`g8.objects.listAttributes()`](../sdk-clients.md#g8-objects-listattributes)
 
@@ -914,6 +1395,7 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `is_system` | `boolean` | no | Whether this field is protected as a system attribute. default `false` |
 | `is_unique` | `boolean` | no | No two active records may hold the same value for this attribute. A collision is rejected with `409 duplicate_active_value`. default `false` |
 | `sort_order` | `integer` | no | Configured display order; equal values are ordered by API slug. default `0` |
+| `visible_to_role_ids` | `Array<string> \| null` | no | Role ids that may see this field; null means every role. Owners and admins always see every field. A field hidden from the caller is absent from every response. Set it with PATCH on this attribute. |
 
 **Example**
 
@@ -923,6 +1405,57 @@ const result = await g8.api.objects.listObjectAttributes({ path: { object_slug:
 
 ---
 
+<a id="op-listobjectcsvimports"></a>
+
+### `g8.api.objects.listObjectCsvImports(input)`
+
+**List Object Csv Imports**
+
+- HTTP: `GET /api/v1/objects/{object_slug}/imports/csv/drafts`
+- operationId: `list_object_csv_imports_objects__object_slug__imports_csv_drafts_get` (also callable as `g8.api.call("list_object_csv_imports_objects__object_slug__imports_csv_drafts_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `objects:write`
+
+List this credential's CSV imports for the object, newest first. History only: no file contents or cell values.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.object_slug` | `string` | yes |  |
+| `query.limit` | `integer` | no | default `25` |
+| `query.offset` | `integer` | no | default `0` |
+
+**Returns** `ApiResponse_list_ObjectImportSummary__`: the envelope `{ data: Array<ObjectImportSummary>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`ObjectImportSummary` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `completed` | `integer` | yes |  |
+| `created_at` | `string (date-time)` | yes |  |
+| `error_rows` | `integer` | yes |  |
+| `expires_at` | `string (date-time)` | yes |  |
+| `filename` | `string` | yes |  |
+| `id` | `string (uuid)` | yes |  |
+| `owner_id` | `string` | yes |  |
+| `owner_type` | `"user" \| "api"` | yes |  |
+| `revision` | `integer` | yes |  |
+| `source_available` | `boolean` | yes |  |
+| `status` | `"draft" \| "partial" \| "completed" \| "expired"` | yes |  |
+| `total` | `integer` | yes |  |
+| `updated_at` | `string (date-time)` | yes |  |
+
+**Example**
+
+```ts
+const result = await g8.api.objects.listObjectCsvImports({ path: { object_slug: "example" } });
+```
+
+---
+
 <a id="op-listobjectrecords"></a>
 
 ### `g8.api.objects.listObjectRecords(input)`
@@ -977,6 +1510,55 @@ const result = await g8.api.objects.listObjectRecords({ path: { object_slug: "ex
 
 ---
 
+<a id="op-listobjectviews"></a>
+
+### `g8.api.objects.listObjectViews(input)`
+
+**List Object Views**
+
+- HTTP: `GET /api/v1/objects/{object_slug}/views`
+- operationId: `list_object_views_objects__object_slug__views_get` (also callable as `g8.api.call("list_object_views_objects__object_slug__views_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `objects:read`
+
+List this credential's private views and shared workspace views. Views never grant record access.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.object_slug` | `string` | yes |  |
+
+**Returns** `ApiResponse_list_SavedViewResponse__`: the envelope `{ data: Array<SavedViewResponse>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`SavedViewResponse` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `context_key` | `string \| null` | yes |  |
+| `created_at` | `string (date-time) \| null` | yes |  |
+| `created_by` | `string` | yes |  |
+| `description` | `string \| null` | yes |  |
+| `entity_type` | `EntityType` | yes |  |
+| `id` | `string (uuid)` | yes |  |
+| `is_default` | `boolean` | yes |  |
+| `is_owner` | `boolean` | yes |  |
+| `is_reusable` | `boolean` | yes |  |
+| `state` | `Record<string, unknown>` | yes |  |
+| `title` | `string` | yes |  |
+| `updated_at` | `string (date-time) \| null` | yes |  |
+| `visibility` | `Visibility` | yes |  |
+
+**Example**
+
+```ts
+const result = await g8.api.objects.listObjectViews({ path: { object_slug: "example" } });
+```
+
+---
+
 <a id="op-listobjects"></a>
 
 ### `g8.api.objects.listObjects(input?)`
@@ -1086,6 +1668,166 @@ const result = await g8.api.objects.mergeObjectRecords({
 
 ---
 
+<a id="op-previewobjectcsvimport"></a>
+
+### `g8.api.objects.previewObjectCsvImport(input)`
+
+**Preview Object Csv Import**
+
+- HTTP: `POST /api/v1/objects/{object_slug}/imports/csv/drafts/{draft_id}/preview`
+- operationId: `preview_object_csv_import_objects__object_slug__imports_csv_drafts__draft_id__preview_post` (also callable as `g8.api.call("preview_object_csv_import_objects__object_slug__imports_csv_drafts__draft_id__preview_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `objects:write`
+
+Preview up to 100 rows of the stored file: normalized values, errors, upsert matches and rows already imported.
+Writes no records. Empty cells are omitted; \N clears a field.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.object_slug` | `string` | yes |  |
+| `path.draft_id` | `string (uuid)` | yes |  |
+| `body` | `ImportPage` | yes | Request body; fields below. |
+
+Body fields (`ImportPage`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.revision` | `integer` | yes | The draft revision this page was planned against min 1 |
+| `body.limit` | `integer` | no | default `100`, min 1, max 100 |
+| `body.offset` | `integer` | no | default `0`, min 0, max 4999 |
+
+**Returns** `ApiResponse_ObjectCsvPreview_`: the envelope `{ data: ObjectCsvPreview, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`ObjectCsvPreview` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `completed` | `integer` | yes |  |
+| `next_offset` | `integer \| null` | yes |  |
+| `rows` | `Array<ImportPreviewRow>` | yes |  |
+| `schema_fingerprint` | `string` | yes |  |
+| `total` | `integer` | yes |  |
+
+**Example**
+
+```ts
+const result = await g8.api.objects.previewObjectCsvImport({
+  path: {
+    object_slug: "example",
+    draft_id: "00000000-0000-0000-0000-000000000000",
+  },
+  body: { revision: 1 },
+});
+```
+
+---
+
+<a id="op-queryobjectboardgroups"></a>
+
+### `g8.api.objects.queryObjectBoardGroups(input)`
+
+**Query Object Board Groups**
+
+- HTTP: `POST /api/v1/objects/{object_slug}/views/board/groups`
+- operationId: `query_object_board_groups_objects__object_slug__views_board_groups_post` (also callable as `g8.api.call("query_object_board_groups_objects__object_slug__views_board_groups_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `objects:read`
+
+Read status groups and full filtered counts. This POST performs no writes.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.object_slug` | `string` | yes |  |
+| `body` | `ObjectViewState` | yes | Request body; fields below. |
+
+Body fields (`ObjectViewState`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.columns` | `Array<string> \| null` | no | max items 200 |
+| `body.filters` | `Array<RecordFilter>` | no | max items 10 |
+| `body.groupBy` | `string \| null` | no |  |
+| `body.includeArchived` | `boolean` | no | default `false` |
+| `body.layout` | `"table" \| "board"` | no | default `"table"` |
+| `body.search` | `string` | no | default `""`, max length 200 |
+| `body.sortBy` | `string \| null` | no |  |
+| `body.sortOrder` | `"asc" \| "desc"` | no | default `"desc"` |
+| `body.version` | `1` | no | default `1` |
+
+**Returns** `ApiResponse_list_ObjectBoardGroup__`: the envelope `{ data: Array<ObjectBoardGroup>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`ObjectBoardGroup` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `label` | `string` | yes |  |
+| `total` | `integer` | yes |  |
+| `value` | `string \| null` | yes |  |
+
+**Example**
+
+```ts
+const result = await g8.api.objects.queryObjectBoardGroups({ path: { object_slug: "example" }, body: {} });
+```
+
+---
+
+<a id="op-queryobjectboardrecords"></a>
+
+### `g8.api.objects.queryObjectBoardRecords(input)`
+
+**Query Object Board Records**
+
+- HTTP: `POST /api/v1/objects/{object_slug}/views/board/records`
+- operationId: `query_object_board_records_objects__object_slug__views_board_records_post` (also callable as `g8.api.call("query_object_board_records_objects__object_slug__views_board_records_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `objects:read`
+
+Read a bounded status page with current record revisions. This POST performs no writes.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.object_slug` | `string` | yes |  |
+| `body` | `ObjectBoardPage` | yes | Request body; fields below. |
+
+Body fields (`ObjectBoardPage`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.state` | `ObjectViewState` | yes |  |
+| `body.group_value` | `string \| null` | no | max length 500 |
+| `body.limit` | `integer` | no | default `20`, min 1, max 50 |
+| `body.offset` | `integer` | no | default `0`, min 0, max 1000000 |
+
+**Returns** `ApiResponse_RecordListResponse_`: the envelope `{ data: RecordListResponse, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`RecordListResponse` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `records` | `Array<RecordResponse>` | yes |  |
+| `total` | `integer` | yes |  |
+
+**Example**
+
+```ts
+const result = await g8.api.objects.queryObjectBoardRecords({ path: { object_slug: "example" }, body: { state: {} } });
+```
+
+---
+
 <a id="op-restoreobjectrecord"></a>
 
 ### `g8.api.objects.restoreObjectRecord(input)`
@@ -1135,6 +1877,62 @@ const result = await g8.api.objects.restoreObjectRecord({ path: { object_slug: "
 
 ---
 
+<a id="op-setdefaultobjectview"></a>
+
+### `g8.api.objects.setDefaultObjectView(input)`
+
+**Set Default Object View**
+
+- HTTP: `PUT /api/v1/objects/{object_slug}/views/default`
+- operationId: `set_default_object_view_objects__object_slug__views_default_put` (also callable as `g8.api.call("set_default_object_view_objects__object_slug__views_default_put", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `objects:write`
+
+Set or clear this credential's default within this object. Human defaults are unaffected.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.object_slug` | `string` | yes |  |
+| `body` | `ObjectViewDefault` | yes | Request body; fields below. |
+
+Body fields (`ObjectViewDefault`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.view_id` | `string (uuid) \| null` | no |  |
+
+**Returns** `ApiResponse_Union_SavedViewResponse__NoneType__`: the envelope `{ data: SavedViewResponse | null, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`data` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `context_key` | `string \| null` | yes |  |
+| `created_at` | `string (date-time) \| null` | yes |  |
+| `created_by` | `string` | yes |  |
+| `description` | `string \| null` | yes |  |
+| `entity_type` | `EntityType` | yes |  |
+| `id` | `string (uuid)` | yes |  |
+| `is_default` | `boolean` | yes |  |
+| `is_owner` | `boolean` | yes |  |
+| `is_reusable` | `boolean` | yes |  |
+| `state` | `Record<string, unknown>` | yes |  |
+| `title` | `string` | yes |  |
+| `updated_at` | `string (date-time) \| null` | yes |  |
+| `visibility` | `Visibility` | yes |  |
+
+**Example**
+
+```ts
+const result = await g8.api.objects.setDefaultObjectView({ path: { object_slug: "example" }, body: {} });
+```
+
+---
+
 <a id="op-updateattribute"></a>
 
 ### `g8.api.objects.updateAttribute(input)`
@@ -1147,7 +1945,8 @@ const result = await g8.api.objects.restoreObjectRecord({ path: { object_slug: "
 - API-key scope: `objects:manage`
 - ★ Hand-written: [`g8.objects.updateAttribute()`](../sdk-clients.md#g8-objects-updateattribute)
 
-Edit or restore a field; omitted values remain unchanged. Type and slug are immutable.
+Edit or restore a field; omitted values remain unchanged. Type and slug are immutable. A change that would
+break a computed field is refused (409 `formula_dependency`) with every dependent the credential may see.
 
 **Input**
 
@@ -1171,6 +1970,7 @@ Body fields (`AttributeUpdateRequest`):
 | `body.is_unique` | `boolean \| null` | no |  |
 | `body.sort_order` | `integer \| null` | no |  |
 | `body.title` | `string \| null` | no | min length 1, max length 200 |
+| `body.visible_to_role_ids` | `Array<string (uuid)> \| null` | no | max items 100 |
 
 **Returns** `ApiResponse_AttributeDefinitionResponse_`: the envelope `{ data: AttributeDefinitionResponse, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
 
@@ -1193,6 +1993,7 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `is_system` | `boolean` | no | Whether this field is protected as a system attribute. default `false` |
 | `is_unique` | `boolean` | no | No two active records may hold the same value for this attribute. A collision is rejected with `409 duplicate_active_value`. default `false` |
 | `sort_order` | `integer` | no | Configured display order; equal values are ordered by API slug. default `0` |
+| `visible_to_role_ids` | `Array<string> \| null` | no | Role ids that may see this field; null means every role. Owners and admins always see every field. A field hidden from the caller is absent from every response. Set it with PATCH on this attribute. |
 
 **Example**
 
@@ -1217,7 +2018,8 @@ const result = await g8.api.objects.updateAttribute({ path: { object_slug: "exam
 
 PREVIEW. This endpoint is deployed but gated: it returns 404 unless the hosted app platform is enabled for your organization. It is published here so the contract describes the whole surface, not so it can be called today.
 
-Rename, archive or restore a custom object while retaining its slug and data.
+Rename, archive or restore a custom object while retaining its slug and data. Archiving is refused (409
+`formula_dependency`) while a computed field elsewhere reads it, naming every dependent the credential may see.
 
 **Input**
 
@@ -1262,6 +2064,77 @@ const result = await g8.api.objects.updateObject({ path: { object_slug: "example
 
 ---
 
+<a id="op-updateobjectcsvimport"></a>
+
+### `g8.api.objects.updateObjectCsvImport(input)`
+
+**Update Object Csv Import**
+
+- HTTP: `PUT /api/v1/objects/{object_slug}/imports/csv/drafts/{draft_id}`
+- operationId: `update_object_csv_import_objects__object_slug__imports_csv_drafts__draft_id__put` (also callable as `g8.api.call("update_object_csv_import_objects__object_slug__imports_csv_drafts__draft_id__put", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `objects:write`
+
+Change the filename or setup. revision must be the import's current revision. The stored file never changes.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.object_slug` | `string` | yes |  |
+| `path.draft_id` | `string (uuid)` | yes |  |
+| `query.revision` | `integer` | yes |  |
+| `body` | `ObjectImportUpdate` | yes | Request body; fields below. |
+
+Body fields (`ObjectImportUpdate`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.filename` | `string` | yes | min length 1, max length 255 |
+| `body.mapping` | `Record<string, string>` | no |  |
+| `body.matching_attribute` | `string \| null` | no | max length 100 |
+| `body.mode` | `"create" \| "upsert"` | no | default `"create"` |
+
+**Returns** `ApiResponse_ObjectImportDetail_`: the envelope `{ data: ObjectImportDetail, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`ObjectImportDetail` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `completed` | `integer` | yes |  |
+| `created_at` | `string (date-time)` | yes |  |
+| `error_rows` | `integer` | yes |  |
+| `expires_at` | `string (date-time)` | yes |  |
+| `filename` | `string` | yes |  |
+| `headers` | `Array<string>` | yes |  |
+| `id` | `string (uuid)` | yes |  |
+| `owner_id` | `string` | yes |  |
+| `owner_type` | `"user" \| "api"` | yes |  |
+| `revision` | `integer` | yes |  |
+| `setup` | `ObjectImportSetup` | yes |  |
+| `source_available` | `boolean` | yes |  |
+| `status` | `"draft" \| "partial" \| "completed" \| "expired"` | yes |  |
+| `total` | `integer` | yes |  |
+| `updated_at` | `string (date-time)` | yes |  |
+| `sample` | `Array<Array<string>>` | no | First rows of the file while it is still stored |
+
+**Example**
+
+```ts
+const result = await g8.api.objects.updateObjectCsvImport({
+  path: {
+    object_slug: "example",
+    draft_id: "00000000-0000-0000-0000-000000000000",
+  },
+  query: { revision: 1 },
+  body: { filename: "Example" },
+});
+```
+
+---
+
 <a id="op-updateobjectrecord"></a>
 
 ### `g8.api.objects.updateObjectRecord(input)`
@@ -1325,6 +2198,70 @@ const result = await g8.api.objects.updateObjectRecord({ path: { object_slug: "e
 
 ---
 
+<a id="op-updateobjectview"></a>
+
+### `g8.api.objects.updateObjectView(input)`
+
+**Update Object View**
+
+- HTTP: `PUT /api/v1/objects/{object_slug}/views/{view_id}`
+- operationId: `update_object_view_objects__object_slug__views__view_id__put` (also callable as `g8.api.call("update_object_view_objects__object_slug__views__view_id__put", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `objects:write`
+
+Rename or replace settings on a view owned by this credential.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.object_slug` | `string` | yes |  |
+| `path.view_id` | `string (uuid)` | yes |  |
+| `body` | `ObjectViewUpdate` | yes | Request body; fields below. |
+
+Body fields (`ObjectViewUpdate`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.state` | `ObjectViewState \| null` | no |  |
+| `body.title` | `string \| null` | no | min length 1, max length 120 |
+
+**Returns** `ApiResponse_SavedViewResponse_`: the envelope `{ data: SavedViewResponse, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`SavedViewResponse` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `context_key` | `string \| null` | yes |  |
+| `created_at` | `string (date-time) \| null` | yes |  |
+| `created_by` | `string` | yes |  |
+| `description` | `string \| null` | yes |  |
+| `entity_type` | `EntityType` | yes |  |
+| `id` | `string (uuid)` | yes |  |
+| `is_default` | `boolean` | yes |  |
+| `is_owner` | `boolean` | yes |  |
+| `is_reusable` | `boolean` | yes |  |
+| `state` | `Record<string, unknown>` | yes |  |
+| `title` | `string` | yes |  |
+| `updated_at` | `string (date-time) \| null` | yes |  |
+| `visibility` | `Visibility` | yes |  |
+
+**Example**
+
+```ts
+const result = await g8.api.objects.updateObjectView({
+  path: {
+    object_slug: "example",
+    view_id: "00000000-0000-0000-0000-000000000000",
+  },
+  body: {},
+});
+```
+
+---
+
 <a id="op-upsertobjectrecord"></a>
 
 ### `g8.api.objects.upsertObjectRecord(input)`
@@ -1384,6 +2321,64 @@ const result = await g8.api.objects.upsertObjectRecord({
 
 ---
 
+<a id="op-validateformula"></a>
+
+### `g8.api.objects.validateFormula(input)`
+
+**Validate Formula**
+
+- HTTP: `POST /api/v1/objects/{object_slug}/attributes/formula/validate`
+- operationId: `validate_formula_objects__object_slug__attributes_formula_validate_post` (also callable as `g8.api.call("validate_formula_objects__object_slug__attributes_formula_validate_post", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `objects:read`
+
+Dry-run type-check and cycle-check of a typed formula expression, optionally evaluated on one record.
+Nothing is stored. Read-only (`objects:read`) despite the POST verb: the expression travels in the body. The
+check uses YOUR view of the schema: a field you cannot see or an object you cannot read is unknown, and a preview
+that names one is `valid: false` with `unknown_field` (200), exactly like a name that does not exist. An admin key
+is held to the same object grants: API keys never bypass them.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.object_slug` | `string` | yes |  |
+| `body` | `FormulaValidateRequest` | yes | Request body; fields below. |
+
+Body fields (`FormulaValidateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.expression` | `Record<string, unknown>` | yes | The typed JSON expression (a node tree; a rollup is a `rollup` node). |
+| `body.attribute_slug` | `string \| null` | no | Slug of the computed field being EDITED (checked against its own place in the dependency graph); omit for a new one. max length 100 |
+| `body.preview_record_id` | `string \| null` | no | Evaluate the expression against this record's current values. max length 64 |
+
+**Returns** `ApiResponse_FormulaValidateResponse_`: the envelope `{ data: FormulaValidateResponse, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`FormulaValidateResponse` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `valid` | `boolean` | yes |  |
+| `currency_code` | `string \| null` | no |  |
+| `depends_on` | `Array<Record<string, unknown>>` | no |  |
+| `errors` | `Array<Record<string, unknown>>` | no | Field-level problems (`reason` is a stable code). |
+| `preview_error` | `string \| null` | no | Why the preview record could not be evaluated (a code, never a value). |
+| `preview_rollups` | `Array<PreviewRollup>` | no | With a preview record: one entry per rollup in the expression, counted over the records the caller may read. |
+| `preview_value` | `unknown` | no |  |
+| `referenced_object_slugs` | `Array<string>` | no |  |
+| `result_type` | `string \| null` | no | number, currency, text, checkbox, date or timestamp. |
+
+**Example**
+
+```ts
+const result = await g8.api.objects.validateFormula({ path: { object_slug: "example" }, body: { expression: {} } });
+```
+
+---
+
 ## Referenced types
 
 Named types that appear in the tables above. Full TypeScript definitions: `G8Contract.<Name>` (`import type { G8Contract } from "@graph8/sdk"`).
@@ -1397,6 +2392,7 @@ Configuration for specific attribute types.
 | Field | Type | Required | Description |
 |---|---|---|---|
 | `currency_code` | `string \| null` | no |  |
+| `formula` | `FormulaInput \| null` | no |  |
 | `max_value` | `integer \| null` | no |  |
 | `options` | `Array<Record<string, unknown>> \| null` | no |  |
 | `referenced_object` | `string \| null` | no |  |
@@ -1410,14 +2406,95 @@ Valid attribute types for the Custom Objects type system.
 
 Type: `"text" | "number" | "currency" | "date" | "timestamp" | "checkbox" | "select" | "status" | …`.
 
+<a id="type-entitytype"></a>
+
+### `EntityType`
+
+Which CRM grid the saved view applies to. Free-form string at the DB level (cb_saved_views.entity_type is VARCHAR(50)) to avoid a schema migration when we add deals/tasks/leads — but enforced as an enum at the API boundary so we don't accept typos. NEITHER A SUBSET NOR A SUPERSET OF ``FilterEntityType`` — see the invariant on that class, and the sibling docstring below, which states the same relationship from the other side. The two enums overlap on the four GRID values (``contacts``, ``companies``, ``deals``, ``leads``); ``FilterEntityType`` is a superset of THOSE and adds ``report``, while…
+
+Type: `"custom_objects" | "contacts" | "companies" | "deals" | "leads" | "lists" | "contacts_view" | "companies_view" | …`.
+
+<a id="type-importpreviewrow"></a>
+
+### `ImportPreviewRow`
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `row_number` | `integer` | yes | min 2 |
+| `already_imported` | `boolean` | no | default `false` |
+| `errors` | `Array<Record<string, unknown>>` | no |  |
+| `record_id` | `string (uuid) \| null` | no |  |
+| `revision` | `integer \| null` | no | min 1 |
+| `values` | `Record<string, unknown>` | no |  |
+
+<a id="type-importreceiptrow"></a>
+
+### `ImportReceiptRow`
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `action` | `"created" \| "updated"` | yes |  |
+| `record_id` | `string (uuid)` | yes |  |
+| `revision` | `integer` | yes |  |
+| `row_number` | `integer` | yes |  |
+| `replayed` | `boolean` | no | default `false` |
+
+<a id="type-importrowexpectation"></a>
+
+### `ImportRowExpectation`
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `row_number` | `integer` | yes | min 2 |
+| `record_id` | `string (uuid) \| null` | no |  |
+| `revision` | `integer \| null` | no | min 1 |
+
+<a id="type-importskippedrow"></a>
+
+### `ImportSkippedRow`
+
+A row this commit did not import; its errors are kept for the error file.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `errors` | `Array<Record<string, unknown>>` | yes |  |
+| `row_number` | `integer` | yes |  |
+
+<a id="type-objectimportsetup"></a>
+
+### `ObjectImportSetup`
+
+Column mapping (CSV header -> field slug) and match mode. May be incomplete while saved; preview and commit need an executable setup.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `mapping` | `Record<string, string>` | no |  |
+| `matching_attribute` | `string \| null` | no | max length 100 |
+| `mode` | `"create" \| "upsert"` | no | default `"create"` |
+
+<a id="type-previewrollup"></a>
+
+### `PreviewRollup`
+
+How many linked records one rollup of a previewed expression counted.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `matched_count` | `integer` | yes | Linked records the rollup counted for the preview record (the ones its filters keep). |
+| `node_path` | `string` | yes | Where the rollup sits in the expression: `$` is the root, `$.left`, `$.args[1]`, `$.then_branch`. |
+
 <a id="type-recordbulkupdatefailure"></a>
 
 ### `RecordBulkUpdateFailure`
 
+One record a bulk update did not change. ``error`` is the human message (kept for existing clients); ``code`` is stable for UIs to branch on: locked, archived, not_found, scope_changed, unique_conflict, invalid_value, constraint_violation or rejected; ``attribute_slug`` names the field when one field caused it.
+
 | Field | Type | Required | Description |
 |---|---|---|---|
 | `error` | `string` | yes |  |
 | `id` | `string (uuid)` | yes |  |
+| `attribute_slug` | `string \| null` | no |  |
+| `code` | `string` | no | default `"rejected"` |
 
 <a id="type-recordfilter"></a>
 
@@ -1471,7 +2548,7 @@ One generation of one attribute's value. Values are TEMPORAL rather than mutable
 
 | Field | Type | Required | Description |
 |---|---|---|---|
-| `action` | `"created" \| "updated" \| "archived" \| "restored"` | yes |  |
+| `action` | `"created" \| "updated" \| "archived" \| "restored" \| "recalculated"` | yes |  |
 | `actor_id` | `string \| null` | yes |  |
 | `actor_type` | `"user" \| "api" \| "app" \| "integration" \| "system"` | yes |  |
 | `changes` | `Record<string, RecordMutationValueChange>` | yes |  |
@@ -1541,3 +2618,11 @@ Response for a record with its current attribute values.
 | `target_label` | `string` | yes |  |
 | `target_many` | `boolean` | yes |  |
 | `target_object_definition_id` | `string (uuid) \| null` | yes |  |
+
+<a id="type-visibility"></a>
+
+### `Visibility`
+
+Who can apply a view. Only the creator can update or delete it.
+
+Type: `"private" | "org"`.