@graph8/sdk 0.303.0 → 0.357.0

package/docs/api/objects.d.ts

@@ -1,7 +1,7 @@
 /* Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. */
 
 /**
- * Types for `g8.api.objects` (Objects): 24 operations.
+ * Types for `g8.api.objects` (Objects): 42 operations.
  *
  * For reading. In code, import from the package instead:
  *   import type { ApiInput, ApiOutput, G8Contract } from "@graph8/sdk";
@@ -17,26 +17,44 @@ export interface ObjectsMembers {
   archiveObject: "archive_object_objects__object_slug__delete";
   archiveObjectRecord: "archive_object_record_objects__object_slug__records__record_id__delete";
   bulkUpdateObjectRecords: "bulk_update_object_records_objects__object_slug__records_bulk_patch";
+  commitObjectCsvImport: "commit_object_csv_import_objects__object_slug__imports_csv_drafts__draft_id__commit_post";
   createAttribute: "create_attribute_objects__object_slug__attributes_post";
   createObject: "create_object_objects_post";
+  createObjectCsvImport: "create_object_csv_import_objects__object_slug__imports_csv_drafts_post";
   createObjectRecord: "create_object_record_objects__object_slug__records_post";
   createObjectRelationship: "create_object_relationship_objects__object_slug__records__record_id__relationships_post";
+  createObjectView: "create_object_view_objects__object_slug__views_post";
+  deleteObjectCsvImport: "delete_object_csv_import_objects__object_slug__imports_csv_drafts__draft_id__delete";
   deleteObjectRelationship: "delete_object_relationship_objects__object_slug__records__record_id__relationships__relationship_id__delete";
+  deleteObjectView: "delete_object_view_objects__object_slug__views__view_id__delete";
+  downloadObjectCsvImportErrors: "download_object_csv_import_errors_objects__object_slug__imports_csv_drafts__draft_id__errors_get";
+  exportObjectRecords: "export_object_records_objects__object_slug__exports_post";
   getObject: "get_object_objects__object_slug__get";
+  getObjectCsvImport: "get_object_csv_import_objects__object_slug__imports_csv_drafts__draft_id__get";
   getObjectRecord: "get_object_record_objects__object_slug__records__record_id__get";
   getObjectRecordChanges: "get_object_record_changes_objects__object_slug__records__record_id__changes_get";
   getObjectRecordHistory: "get_object_record_history_objects__object_slug__records__record_id__history_get";
   getObjectRelationshipDefinitions: "get_object_relationship_definitions_objects__object_slug__relationships_get";
   getObjectRelationships: "get_object_relationships_objects__object_slug__records__record_id__relationships_get";
+  inspectObjectCsvImport: "inspect_object_csv_import_objects__object_slug__imports_csv_inspect_post";
   listObjectAttributes: "list_object_attributes_objects__object_slug__attributes_get";
+  listObjectCsvImports: "list_object_csv_imports_objects__object_slug__imports_csv_drafts_get";
   listObjectRecords: "list_object_records_objects__object_slug__records_get";
+  listObjectViews: "list_object_views_objects__object_slug__views_get";
   listObjects: "list_objects_objects_get";
   mergeObjectRecords: "merge_object_records_objects__object_slug__records_merge_post";
+  previewObjectCsvImport: "preview_object_csv_import_objects__object_slug__imports_csv_drafts__draft_id__preview_post";
+  queryObjectBoardGroups: "query_object_board_groups_objects__object_slug__views_board_groups_post";
+  queryObjectBoardRecords: "query_object_board_records_objects__object_slug__views_board_records_post";
   restoreObjectRecord: "restore_object_record_objects__object_slug__records__record_id__restore_post";
+  setDefaultObjectView: "set_default_object_view_objects__object_slug__views_default_put";
   updateAttribute: "update_attribute_objects__object_slug__attributes__attr_slug__patch";
   updateObject: "update_object_objects__object_slug__patch";
+  updateObjectCsvImport: "update_object_csv_import_objects__object_slug__imports_csv_drafts__draft_id__put";
   updateObjectRecord: "update_object_record_objects__object_slug__records__record_id__patch";
+  updateObjectView: "update_object_view_objects__object_slug__views__view_id__put";
   upsertObjectRecord: "upsert_object_record_objects__object_slug__records_upsert_post";
+  validateFormula: "validate_formula_objects__object_slug__attributes_formula_validate_post";
 }
 
 /** Input and output of every `g8.api.objects` operation, keyed by operationId. */
@@ -108,6 +126,24 @@ export interface ObjectsOperations {
   };
     output: ApiResponse_RecordBulkUpdateResponse_;
   };
+  /**
+   * POST /objects/{object_slug}/imports/csv/drafts/{draft_id}/commit
+   * Commit Object Csv Import
+   * tier: write · scope: objects:write
+   */
+  commit_object_csv_import_objects__object_slug__imports_csv_drafts__draft_id__commit_post: {
+    input: {
+    path: {
+      object_slug: string;
+      draft_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ObjectImportCommit;
+  };
+    output: ApiResponse_ObjectCsvReceipt_;
+  };
   /**
    * POST /objects/{object_slug}/attributes
    * Create Attribute
@@ -139,6 +175,23 @@ export interface ObjectsOperations {
   };
     output: ApiResponse_ObjectDefinitionResponse_;
   };
+  /**
+   * POST /objects/{object_slug}/imports/csv/drafts
+   * Create Object Csv Import
+   * tier: write · scope: objects:write
+   */
+  create_object_csv_import_objects__object_slug__imports_csv_drafts_post: {
+    input: {
+    path: {
+      object_slug: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ObjectImportCreate;
+  };
+    output: ApiResponse_ObjectImportDetail_;
+  };
   /**
    * POST /objects/{object_slug}/records
    * Create Object Record
@@ -174,6 +227,43 @@ export interface ObjectsOperations {
   };
     output: ApiResponse_RelationshipResponse_;
   };
+  /**
+   * POST /objects/{object_slug}/views
+   * Create Object View
+   * tier: write · scope: objects:write
+   */
+  create_object_view_objects__object_slug__views_post: {
+    input: {
+    path: {
+      object_slug: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ObjectViewCreate;
+  };
+    output: ApiResponse_SavedViewResponse_;
+  };
+  /**
+   * DELETE /objects/{object_slug}/imports/csv/drafts/{draft_id}
+   * Delete Object Csv Import
+   * tier: destructive · scope: objects:write
+   */
+  delete_object_csv_import_objects__object_slug__imports_csv_drafts__draft_id__delete: {
+    input: {
+    path: {
+      object_slug: string;
+      draft_id: string;
+    };
+    query: {
+      revision: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_dict_;
+  };
   /**
    * DELETE /objects/{object_slug}/records/{record_id}/relationships/{relationship_id}
    * Delete Object Relationship
@@ -193,6 +283,57 @@ export interface ObjectsOperations {
   };
     output: ApiResponse_RelationshipResponse_;
   };
+  /**
+   * DELETE /objects/{object_slug}/views/{view_id}
+   * Delete Object View
+   * tier: destructive · scope: objects:delete
+   */
+  delete_object_view_objects__object_slug__views__view_id__delete: {
+    input: {
+    path: {
+      object_slug: string;
+      view_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_NoneType_;
+  };
+  /**
+   * GET /objects/{object_slug}/imports/csv/drafts/{draft_id}/errors
+   * Download Object Csv Import Errors
+   * tier: read · scope: objects:write
+   */
+  download_object_csv_import_errors_objects__object_slug__imports_csv_drafts__draft_id__errors_get: {
+    input: {
+    path: {
+      object_slug: string;
+      draft_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: unknown;
+  };
+  /**
+   * POST /objects/{object_slug}/exports
+   * Export Object Records
+   * tier: write · scope: objects:export
+   */
+  export_object_records_objects__object_slug__exports_post: {
+    input: {
+    path: {
+      object_slug: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ObjectExportRequest;
+  };
+    output: string;
+  };
   /**
    * GET /objects/{object_slug}
    * Get Object
@@ -209,6 +350,23 @@ export interface ObjectsOperations {
   };
     output: ApiResponse_ObjectDefinitionResponse_;
   };
+  /**
+   * GET /objects/{object_slug}/imports/csv/drafts/{draft_id}
+   * Get Object Csv Import
+   * tier: read · scope: objects:write
+   */
+  get_object_csv_import_objects__object_slug__imports_csv_drafts__draft_id__get: {
+    input: {
+    path: {
+      object_slug: string;
+      draft_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ObjectImportDetail_;
+  };
   /**
    * GET /objects/{object_slug}/records/{record_id}
    * Get Object Record
@@ -309,6 +467,23 @@ export interface ObjectsOperations {
   };
     output: ApiResponse_RecordRelationshipsResponse_;
   };
+  /**
+   * POST /objects/{object_slug}/imports/csv/inspect
+   * Inspect Object Csv Import
+   * tier: write · scope: objects:write
+   */
+  inspect_object_csv_import_objects__object_slug__imports_csv_inspect_post: {
+    input: {
+    path: {
+      object_slug: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ObjectCsvInspect;
+  };
+    output: ApiResponse_ObjectCsvInspection_;
+  };
   /**
    * GET /objects/{object_slug}/attributes
    * List Object Attributes
@@ -328,6 +503,26 @@ export interface ObjectsOperations {
   };
     output: ApiResponse_list_AttributeDefinitionResponse__;
   };
+  /**
+   * GET /objects/{object_slug}/imports/csv/drafts
+   * List Object Csv Imports
+   * tier: read · scope: objects:write
+   */
+  list_object_csv_imports_objects__object_slug__imports_csv_drafts_get: {
+    input: {
+    path: {
+      object_slug: string;
+    };
+    query?: {
+      limit?: number;
+      offset?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_list_ObjectImportSummary__;
+  };
   /**
    * GET /objects/{object_slug}/records
    * List Object Records
@@ -352,6 +547,22 @@ export interface ObjectsOperations {
   };
     output: ApiResponse_list_ObjectRecordResponse__;
   };
+  /**
+   * GET /objects/{object_slug}/views
+   * List Object Views
+   * tier: read · scope: objects:read
+   */
+  list_object_views_objects__object_slug__views_get: {
+    input: {
+    path: {
+      object_slug: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_list_SavedViewResponse__;
+  };
   /**
    * GET /objects
    * List Objects
@@ -385,6 +596,58 @@ export interface ObjectsOperations {
   };
     output: ApiResponse_RecordMergeResponse_;
   };
+  /**
+   * POST /objects/{object_slug}/imports/csv/drafts/{draft_id}/preview
+   * Preview Object Csv Import
+   * tier: write · scope: objects:write
+   */
+  preview_object_csv_import_objects__object_slug__imports_csv_drafts__draft_id__preview_post: {
+    input: {
+    path: {
+      object_slug: string;
+      draft_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ImportPage;
+  };
+    output: ApiResponse_ObjectCsvPreview_;
+  };
+  /**
+   * POST /objects/{object_slug}/views/board/groups
+   * Query Object Board Groups
+   * tier: write · scope: objects:read
+   */
+  query_object_board_groups_objects__object_slug__views_board_groups_post: {
+    input: {
+    path: {
+      object_slug: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ObjectViewState;
+  };
+    output: ApiResponse_list_ObjectBoardGroup__;
+  };
+  /**
+   * POST /objects/{object_slug}/views/board/records
+   * Query Object Board Records
+   * tier: write · scope: objects:read
+   */
+  query_object_board_records_objects__object_slug__views_board_records_post: {
+    input: {
+    path: {
+      object_slug: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ObjectBoardPage;
+  };
+    output: ApiResponse_RecordListResponse_;
+  };
   /**
    * POST /objects/{object_slug}/records/{record_id}/restore
    * Restore Object Record
@@ -402,6 +665,23 @@ export interface ObjectsOperations {
   };
     output: ApiResponse_ObjectRecordResponse_;
   };
+  /**
+   * PUT /objects/{object_slug}/views/default
+   * Set Default Object View
+   * tier: write · scope: objects:write
+   */
+  set_default_object_view_objects__object_slug__views_default_put: {
+    input: {
+    path: {
+      object_slug: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ObjectViewDefault;
+  };
+    output: ApiResponse_Union_SavedViewResponse__NoneType__;
+  };
   /**
    * PATCH /objects/{object_slug}/attributes/{attr_slug}
    * Update Attribute
@@ -437,6 +717,27 @@ export interface ObjectsOperations {
   };
     output: ApiResponse_ObjectDefinitionResponse_;
   };
+  /**
+   * PUT /objects/{object_slug}/imports/csv/drafts/{draft_id}
+   * Update Object Csv Import
+   * tier: write · scope: objects:write
+   */
+  update_object_csv_import_objects__object_slug__imports_csv_drafts__draft_id__put: {
+    input: {
+    path: {
+      object_slug: string;
+      draft_id: string;
+    };
+    query: {
+      revision: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ObjectImportUpdate;
+  };
+    output: ApiResponse_ObjectImportDetail_;
+  };
   /**
    * PATCH /objects/{object_slug}/records/{record_id}
    * Update Object Record
@@ -455,6 +756,24 @@ export interface ObjectsOperations {
   };
     output: ApiResponse_ObjectRecordResponse_;
   };
+  /**
+   * PUT /objects/{object_slug}/views/{view_id}
+   * Update Object View
+   * tier: write · scope: objects:write
+   */
+  update_object_view_objects__object_slug__views__view_id__put: {
+    input: {
+    path: {
+      object_slug: string;
+      view_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ObjectViewUpdate;
+  };
+    output: ApiResponse_SavedViewResponse_;
+  };
   /**
    * POST /objects/{object_slug}/records/upsert
    * Upsert Object Record
@@ -472,20 +791,67 @@ export interface ObjectsOperations {
   };
     output: ApiResponse_ObjectRecordResponse_;
   };
+  /**
+   * POST /objects/{object_slug}/attributes/formula/validate
+   * Validate Formula
+   * tier: read · scope: objects:read
+   */
+  validate_formula_objects__object_slug__attributes_formula_validate_post: {
+    input: {
+    path: {
+      object_slug: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: FormulaValidateRequest;
+  };
+    output: ApiResponse_FormulaValidateResponse_;
+  };
 }
 
-// 46 schemas referenced above (the same as G8Contract.<Name>).
+// 89 schemas referenced above (the same as G8Contract.<Name>).
 
 export interface ApiResponse_AttributeDefinitionResponse_ {
   data: AttributeDefinitionResponse;
   pagination?: PaginationMeta | null;
 }
 
+export interface ApiResponse_FormulaValidateResponse_ {
+  data: FormulaValidateResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_NoneType_ {
+  data: null;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_ObjectCsvInspection_ {
+  data: ObjectCsvInspection;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_ObjectCsvPreview_ {
+  data: ObjectCsvPreview;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_ObjectCsvReceipt_ {
+  data: ObjectCsvReceipt;
+  pagination?: PaginationMeta | null;
+}
+
 export interface ApiResponse_ObjectDefinitionResponse_ {
   data: ObjectDefinitionResponse;
   pagination?: PaginationMeta | null;
 }
 
+export interface ApiResponse_ObjectImportDetail_ {
+  data: ObjectImportDetail;
+  pagination?: PaginationMeta | null;
+}
+
 export interface ApiResponse_ObjectRecordResponse_ {
   data: ObjectRecordResponse;
   pagination?: PaginationMeta | null;
@@ -501,6 +867,11 @@ export interface ApiResponse_RecordHistoryResponse_ {
   pagination?: PaginationMeta | null;
 }
 
+export interface ApiResponse_RecordListResponse_ {
+  data: RecordListResponse;
+  pagination?: PaginationMeta | null;
+}
+
 export interface ApiResponse_RecordMergeResponse_ {
   data: RecordMergeResponse;
   pagination?: PaginationMeta | null;
@@ -526,24 +897,55 @@ export interface ApiResponse_RelationshipResponse_ {
   pagination?: PaginationMeta | null;
 }
 
+export interface ApiResponse_SavedViewResponse_ {
+  data: SavedViewResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_Union_SavedViewResponse__NoneType__ {
+  data: SavedViewResponse | null;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_dict_ {
+  data: Record<string, unknown>;
+  pagination?: PaginationMeta | null;
+}
+
 export interface ApiResponse_list_AttributeDefinitionResponse__ {
   data: Array<AttributeDefinitionResponse>;
   pagination?: PaginationMeta | null;
 }
 
+export interface ApiResponse_list_ObjectBoardGroup__ {
+  data: Array<ObjectBoardGroup>;
+  pagination?: PaginationMeta | null;
+}
+
 export interface ApiResponse_list_ObjectDefinitionResponse__ {
   data: Array<ObjectDefinitionResponse>;
   pagination?: PaginationMeta | null;
 }
 
+export interface ApiResponse_list_ObjectImportSummary__ {
+  data: Array<ObjectImportSummary>;
+  pagination?: PaginationMeta | null;
+}
+
 export interface ApiResponse_list_ObjectRecordResponse__ {
   data: Array<ObjectRecordResponse>;
   pagination?: PaginationMeta | null;
 }
 
+export interface ApiResponse_list_SavedViewResponse__ {
+  data: Array<SavedViewResponse>;
+  pagination?: PaginationMeta | null;
+}
+
 /** Configuration for specific attribute types. */
 export interface AttributeConfig {
   currency_code?: string | null;
+  formula?: FormulaInput | null;
   max_value?: number | null;
   options?: Array<Record<string, unknown>> | null;
   referenced_object?: string | null;
@@ -592,10 +994,12 @@ export interface AttributeDefinitionResponse {
   sort_order?: number;
   /** Customer-facing field label, distinct from its stable API slug. */
   title: string;
+  /** 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. */
+  visible_to_role_ids?: Array<string> | null;
 }
 
 /** Valid attribute types for the Custom Objects type system. */
-export type AttributeType = "text" | "number" | "currency" | "date" | "timestamp" | "checkbox" | "select" | "status" | "email_address" | "phone_number" | "domain" | "location" | "personal_name" | "record_reference" | "rating" | "actor_reference";
+export type AttributeType = "text" | "number" | "currency" | "date" | "timestamp" | "checkbox" | "select" | "status" | "email_address" | "phone_number" | "domain" | "location" | "personal_name" | "record_reference" | "rating" | "actor_reference" | "formula";
 
 export interface AttributeUpdateRequest {
   config?: AttributeConfig | null;
@@ -608,6 +1012,118 @@ export interface AttributeUpdateRequest {
   is_unique?: boolean | null;
   sort_order?: number | null;
   title?: string | null;
+  visible_to_role_ids?: Array<string> | null;
+}
+
+/**
+ * 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 the
+ * nine list/view/search/workbench members here have no counterpart there.
+ * Custom objects additionally use an object-bound view context.
+ *
+ * (This paragraph previously read "DELIBERATELY NARROWER THAN
+ * ``FilterEntityType``", which inverted the relationship: this is the LARGER
+ * enum. The narrowness that matters is real but specific — ``report`` is
+ * excluded, and only ``report`` — so stating it as a general containment
+ * invited exactly the wrong conclusion about the other nine.)
+ *
+ * Native grid members can be saved with ``context_key = NULL`` for reuse
+ * across that entity type. CUSTOM_OBJECTS is the exception: it requires an
+ * immutable object context and the object-authorized endpoints. It must never
+ * enter the native grids' reusable saved-filter menus.
+ */
+export type EntityType = "custom_objects" | "contacts" | "companies" | "deals" | "leads" | "lists" | "contacts_view" | "companies_view" | "list_contacts" | "list_companies" | "search_people" | "search_companies" | "abm_companies" | "enrichment_workbench" | "enrichment_workbenches";
+
+/**
+ * Guided-builder input for a computed field (CRM-06): only the typed JSON expression. The result type,
+ * currency, dependencies, input closure and rollup flag are computed and stored server side at save time --
+ * never accepted from a client. A rollup is a ``rollup`` node (the whole expression, or nested).
+ */
+export interface FormulaInput {
+  expression: Record<string, unknown>;
+}
+
+/** Dry-run check of a typed formula expression. Nothing is persisted or locked. */
+export interface FormulaValidateRequest {
+  /** Slug of the computed field being EDITED (checked against its own place in the dependency graph); omit for a new one. */
+  attribute_slug?: string | null;
+  /** The typed JSON expression (a node tree; a rollup is a `rollup` node). */
+  expression: Record<string, unknown>;
+  /** Evaluate the expression against this record's current values. */
+  preview_record_id?: string | null;
+}
+
+export interface FormulaValidateResponse {
+  currency_code?: string | null;
+  depends_on?: Array<Record<string, unknown>>;
+  /** Field-level problems (`reason` is a stable code). */
+  errors?: Array<Record<string, unknown>>;
+  /** Why the preview record could not be evaluated (a code, never a value). */
+  preview_error?: string | null;
+  /** With a preview record: one entry per rollup in the expression, counted over the records the caller may read. */
+  preview_rollups?: Array<PreviewRollup>;
+  preview_value?: unknown;
+  referenced_object_slugs?: Array<string>;
+  /** number, currency, text, checkbox, date or timestamp. */
+  result_type?: string | null;
+  valid: boolean;
+}
+
+export interface ImportPage {
+  limit?: number;
+  offset?: number;
+  /** The draft revision this page was planned against */
+  revision: number;
+}
+
+export interface ImportPreviewRow {
+  already_imported?: boolean;
+  errors?: Array<Record<string, unknown>>;
+  record_id?: string | null;
+  revision?: number | null;
+  row_number: number;
+  values?: Record<string, unknown>;
+}
+
+export interface ImportReceiptRow {
+  action: "created" | "updated";
+  record_id: string;
+  replayed?: boolean;
+  revision: number;
+  row_number: number;
+}
+
+export interface ImportRowExpectation {
+  record_id?: string | null;
+  revision?: number | null;
+  row_number: number;
+}
+
+/** A row this commit did not import; its errors are kept for the error file. */
+export interface ImportSkippedRow {
+  errors: Array<Record<string, unknown>>;
+  row_number: number;
+}
+
+export interface ObjectBoardGroup {
+  label: string;
+  total: number;
+  value: string | null;
+}
+
+export interface ObjectBoardPage {
+  group_value?: string | null;
+  limit?: number;
+  offset?: number;
+  state: ObjectViewState;
 }
 
 export interface ObjectCreateRequest {
@@ -618,6 +1134,44 @@ export interface ObjectCreateRequest {
   slug: string;
 }
 
+export interface ObjectCsvInspect {
+  csv: string;
+}
+
+export interface ObjectCsvInspection {
+  headers: Array<string>;
+  sample: Array<Array<string>>;
+  total: number;
+}
+
+export interface ObjectCsvPreview {
+  completed: number;
+  next_offset: number | null;
+  rows: Array<ImportPreviewRow>;
+  schema_fingerprint: string;
+  total: number;
+}
+
+/**
+ * Outcome of one committed page. ``created`` / ``updated`` / ``skipped`` count
+ * this request only; rows an earlier attempt already imported are
+ * ``already_imported``. ``completed`` and ``error_rows`` are the import's totals.
+ */
+export interface ObjectCsvReceipt {
+  already_imported: number;
+  completed: number;
+  created: number;
+  error_file_available: boolean;
+  error_rows: number;
+  replayed?: boolean;
+  rows: Array<ImportReceiptRow>;
+  skipped: number;
+  skipped_rows?: Array<ImportSkippedRow>;
+  status: "draft" | "partial" | "completed" | "expired";
+  total: number;
+  updated: number;
+}
+
 /** One custom object type in the caller's workspace. */
 export interface ObjectDefinitionResponse {
   /** Customer-configured object description. */
@@ -638,6 +1192,82 @@ export interface ObjectDefinitionResponse {
   slug: string;
 }
 
+export interface ObjectExportRequest {
+  format?: "csv" | "json";
+  state?: ObjectViewState;
+}
+
+export interface ObjectImportCommit {
+  expected: Array<ImportRowExpectation>;
+  limit?: number;
+  offset?: number;
+  /** The draft revision this page was planned against */
+  revision: number;
+  schema_fingerprint: string;
+}
+
+export interface ObjectImportCreate {
+  csv: string;
+  filename: string;
+  mapping?: Record<string, string>;
+  matching_attribute?: string | null;
+  mode?: "create" | "upsert";
+}
+
+export interface ObjectImportDetail {
+  completed: number;
+  created_at: string;
+  error_rows: number;
+  expires_at: string;
+  filename: string;
+  headers: Array<string>;
+  id: string;
+  owner_id: string;
+  owner_type: "user" | "api";
+  revision: number;
+  /** First rows of the file while it is still stored */
+  sample?: Array<Array<string>>;
+  setup: ObjectImportSetup;
+  source_available: boolean;
+  status: "draft" | "partial" | "completed" | "expired";
+  total: number;
+  updated_at: string;
+}
+
+/**
+ * Column mapping (CSV header -> field slug) and match mode. May be
+ * incomplete while saved; preview and commit need an executable setup.
+ */
+export interface ObjectImportSetup {
+  mapping?: Record<string, string>;
+  matching_attribute?: string | null;
+  mode?: "create" | "upsert";
+}
+
+/** History metadata: never cell values. */
+export interface ObjectImportSummary {
+  completed: number;
+  created_at: string;
+  error_rows: number;
+  expires_at: string;
+  filename: string;
+  id: string;
+  owner_id: string;
+  owner_type: "user" | "api";
+  revision: number;
+  source_available: boolean;
+  status: "draft" | "partial" | "completed" | "expired";
+  total: number;
+  updated_at: string;
+}
+
+export interface ObjectImportUpdate {
+  filename: string;
+  mapping?: Record<string, string>;
+  matching_attribute?: string | null;
+  mode?: "create" | "upsert";
+}
+
 /** One record, with its currently active attribute values. */
 export interface ObjectRecordResponse {
   created_at?: string | null;
@@ -663,6 +1293,33 @@ export interface ObjectUpdateRequest {
   singular_noun?: string | null;
 }
 
+export interface ObjectViewCreate {
+  state?: ObjectViewState;
+  title: string;
+  visibility?: Visibility;
+}
+
+export interface ObjectViewDefault {
+  view_id?: string | null;
+}
+
+export interface ObjectViewState {
+  columns?: Array<string> | null;
+  filters?: Array<RecordFilter>;
+  groupBy?: string | null;
+  includeArchived?: boolean;
+  layout?: "table" | "board";
+  search?: string;
+  sortBy?: string | null;
+  sortOrder?: "asc" | "desc";
+  version?: 1;
+}
+
+export interface ObjectViewUpdate {
+  state?: ObjectViewState | null;
+  title?: string | null;
+}
+
 export interface PaginationMeta {
   /** Whether there are more pages */
   has_next: boolean;
@@ -682,6 +1339,14 @@ export interface PaginationMeta {
   total_is_lower_bound?: boolean | null;
 }
 
+/** How many linked records one rollup of a previewed expression counted. */
+export interface PreviewRollup {
+  /** Linked records the rollup counted for the preview record (the ones its filters keep). */
+  matched_count: number;
+  /** Where the rollup sits in the expression: `$` is the root, `$.left`, `$.args[1]`, `$.then_branch`. */
+  node_path: string;
+}
+
 /**
  * Bulk-update body: exactly one scope (explicit ids or a filtered set),
  * plus the values to apply to every record in that scope.
@@ -699,7 +1364,16 @@ export interface RecordBulkUpdate {
   values?: Record<string, unknown>;
 }
 
+/**
+ * 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.
+ */
 export interface RecordBulkUpdateFailure {
+  attribute_slug?: string | null;
+  code?: string;
   error: string;
   id: string;
 }
@@ -714,7 +1388,7 @@ export interface RecordBulkUpdateResponse {
 /** Filter parameters for listing records. */
 export interface RecordFilter {
   attribute_slug: string;
-  operator: "eq" | "ne" | "gt" | "gte" | "lt" | "lte" | "contains" | "starts_with" | "is_null" | "is_not_null";
+  operator: "eq" | "ne" | "gt" | "gte" | "lt" | "lte" | "contains" | "starts_with" | "in" | "is_null" | "is_not_null";
   value?: unknown | null;
 }
 
@@ -745,6 +1419,12 @@ export interface RecordHistoryResponse {
   record_id: string;
 }
 
+/** Response for listing records. */
+export interface RecordListResponse {
+  records: Array<RecordResponse>;
+  total: number;
+}
+
 export interface RecordMergeCascade {
   associations_deleted: number;
   associations_repointed: number;
@@ -777,7 +1457,7 @@ export interface RecordMergeResponse {
 }
 
 export interface RecordMutationEntry {
-  action: "created" | "updated" | "archived" | "restored";
+  action: "created" | "updated" | "archived" | "restored" | "recalculated";
   actor_id: string | null;
   actor_type: "user" | "api" | "app" | "integration" | "system";
   app_id?: string | null;
@@ -911,3 +1591,23 @@ export interface RelationshipResponse {
   target_record_id: string;
   target_revision: number;
 }
+
+/** Response shape — flat shape with state at top level for convenience. */
+export interface SavedViewResponse {
+  context_key: string | null;
+  created_at: string | null;
+  created_by: string;
+  description: string | null;
+  entity_type: EntityType;
+  id: string;
+  is_default: boolean;
+  is_owner: boolean;
+  is_reusable: boolean;
+  state: Record<string, unknown>;
+  title: string;
+  updated_at: string | null;
+  visibility: Visibility;
+}
+
+/** Who can apply a view. Only the creator can update or delete it. */
+export type Visibility = "private" | "org";