@graph8/sdk 0.302.0 → 0.308.1

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): 18 operations.
+ * Types for `g8.api.objects` (Objects): 41 operations.
  *
  * For reading. In code, import from the package instead:
  *   import type { ApiInput, ApiOutput, G8Contract } from "@graph8/sdk";
@@ -16,20 +16,43 @@ export interface ObjectsMembers {
   archiveAttribute: "archive_attribute_objects__object_slug__attributes__attr_slug__delete";
   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";
 }
 
@@ -85,6 +108,41 @@ export interface ObjectsOperations {
   };
     output: ApiResponse_ObjectRecordResponse_;
   };
+  /**
+   * PATCH /objects/{object_slug}/records/bulk
+   * Bulk Update Object Records
+   * tier: write · scope: objects:write
+   */
+  bulk_update_object_records_objects__object_slug__records_bulk_patch: {
+    input: {
+    path: {
+      object_slug: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: RecordBulkUpdate;
+  };
+    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
@@ -116,6 +174,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
@@ -133,6 +208,131 @@ export interface ObjectsOperations {
   };
     output: ApiResponse_ObjectRecordResponse_;
   };
+  /**
+   * POST /objects/{object_slug}/records/{record_id}/relationships
+   * Create Object Relationship
+   * tier: write · scope: objects:write
+   */
+  create_object_relationship_objects__object_slug__records__record_id__relationships_post: {
+    input: {
+    path: {
+      object_slug: string;
+      record_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: RelationshipCreate;
+  };
+    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
+   * tier: destructive · scope: objects:write
+   */
+  delete_object_relationship_objects__object_slug__records__record_id__relationships__relationship_id__delete: {
+    input: {
+    path: {
+      object_slug: string;
+      record_id: string;
+      relationship_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: RelationshipCreate;
+  };
+    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
@@ -149,6 +349,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
@@ -208,6 +425,64 @@ export interface ObjectsOperations {
   };
     output: ApiResponse_RecordHistoryResponse_;
   };
+  /**
+   * GET /objects/{object_slug}/relationships
+   * Get Object Relationship Definitions
+   * tier: read · scope: objects:read
+   */
+  get_object_relationship_definitions_objects__object_slug__relationships_get: {
+    input: {
+    path: {
+      object_slug: string;
+    };
+    query?: {
+      limit?: number;
+      offset?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_RelationshipDefinitionListResponse_;
+  };
+  /**
+   * GET /objects/{object_slug}/records/{record_id}/relationships
+   * Get Object Relationships
+   * tier: read · scope: objects:read
+   */
+  get_object_relationships_objects__object_slug__records__record_id__relationships_get: {
+    input: {
+    path: {
+      object_slug: string;
+      record_id: string;
+    };
+    query?: {
+      limit?: number;
+      offset?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    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
@@ -227,6 +502,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
@@ -251,6 +546,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
@@ -267,6 +578,75 @@ export interface ObjectsOperations {
   };
     output: ApiResponse_list_ObjectDefinitionResponse__;
   };
+  /**
+   * POST /objects/{object_slug}/records/merge
+   * Merge Object Records
+   * tier: write · scope: objects:write
+   */
+  merge_object_records_objects__object_slug__records_merge_post: {
+    input: {
+    path: {
+      object_slug: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: RecordMergeRequest;
+  };
+    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
@@ -284,6 +664,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
@@ -319,6 +716,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
@@ -337,6 +755,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
@@ -356,48 +792,133 @@ export interface ObjectsOperations {
   };
 }
 
-// 26 schemas referenced above (the same as G8Contract.<Name>).
+// 84 schemas referenced above (the same as G8Contract.<Name>).
 
 export interface ApiResponse_AttributeDefinitionResponse_ {
   data: AttributeDefinitionResponse;
   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;
 }
 
+export interface ApiResponse_RecordBulkUpdateResponse_ {
+  data: RecordBulkUpdateResponse;
+  pagination?: PaginationMeta | null;
+}
+
 export interface ApiResponse_RecordHistoryResponse_ {
   data: RecordHistoryResponse;
   pagination?: PaginationMeta | null;
 }
 
+export interface ApiResponse_RecordListResponse_ {
+  data: RecordListResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_RecordMergeResponse_ {
+  data: RecordMergeResponse;
+  pagination?: PaginationMeta | null;
+}
+
 export interface ApiResponse_RecordMutationsResponse_ {
   data: RecordMutationsResponse;
   pagination?: PaginationMeta | null;
 }
 
+export interface ApiResponse_RecordRelationshipsResponse_ {
+  data: RecordRelationshipsResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_RelationshipDefinitionListResponse_ {
+  data: RelationshipDefinitionListResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_RelationshipResponse_ {
+  data: 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;
@@ -449,6 +970,8 @@ 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. */
@@ -465,6 +988,83 @@ 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";
+
+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 {
@@ -475,6 +1075,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. */
@@ -495,6 +1133,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;
@@ -520,6 +1234,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;
@@ -539,6 +1280,51 @@ export interface PaginationMeta {
   total_is_lower_bound?: boolean | null;
 }
 
+/**
+ * Bulk-update body: exactly one scope (explicit ids or a filtered set),
+ * plus the values to apply to every record in that scope.
+ *
+ * ``record_ids`` is capped at 500 to bound the transaction. ``filters`` reuses
+ * this router's own ``RecordFilter`` shape; a filtered scope is resolved
+ * entirely server-side (ordered by record id, at most 500 per call) and the
+ * ids it resolves are never trusted from the client. ``after_record_id``
+ * continues a filtered scope that the previous call reported as truncated.
+ */
+export interface RecordBulkUpdate {
+  after_record_id?: string | null;
+  filters?: Array<RecordFilter> | null;
+  record_ids?: Array<string> | null;
+  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;
+}
+
+export interface RecordBulkUpdateResponse {
+  failed: Array<RecordBulkUpdateFailure>;
+  next_after_record_id?: string | null;
+  succeeded: Array<string>;
+  truncated?: boolean;
+}
+
+/** 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";
+  value?: unknown | null;
+}
+
 /**
  * One generation of one attribute's value.
  *
@@ -566,6 +1352,43 @@ 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;
+  relationships_deleted: number;
+  relationships_repointed: number;
+}
+
+export interface RecordMergeFieldOverride {
+  attribute_slug: string;
+  winner: "primary" | "secondary";
+}
+
+/**
+ * Merge ``secondary_record_id`` into ``primary_record_id``. The primary's
+ * graph8 identity (id, legacy_id/legacy_type) is preserved; the secondary is
+ * archived, never hard-deleted.
+ */
+export interface RecordMergeRequest {
+  expected_primary_revision?: number | null;
+  expected_secondary_revision?: number | null;
+  field_overrides?: Array<RecordMergeFieldOverride>;
+  primary_record_id: string;
+  secondary_record_id: string;
+}
+
+export interface RecordMergeResponse {
+  cascade: RecordMergeCascade;
+  merge_history_id: string;
+  record: RecordResponse;
+}
+
 export interface RecordMutationEntry {
   action: "created" | "updated" | "archived" | "restored";
   actor_id: string | null;
@@ -594,6 +1417,24 @@ export interface RecordMutationsResponse {
   record_id: string;
 }
 
+export interface RecordRelationshipsResponse {
+  /** Next visible page offset; null at the end */
+  next_offset: number | null;
+  relationships: Array<RelatedRecordEdge>;
+}
+
+/** Response for a record with its current attribute values. */
+export interface RecordResponse {
+  created_at: string;
+  id: string;
+  is_archived: boolean;
+  object_definition_id: string;
+  organization_id: string;
+  revision?: number;
+  updated_at: string;
+  values: Record<string, unknown>;
+}
+
 export interface RecordUpdateRequest {
   /** Append canonical non-duplicate values to multivalue fields. Fields must not overlap values or remove_values. */
   append_values?: Record<string, Array<unknown>>;
@@ -625,3 +1466,81 @@ export interface RecordWriteRequest {
   /** Attribute values keyed by slug. Call `GET /objects/{object_slug}/attributes` for active fields. Canonical contacts and companies retain CONTACT_*, COMPANY_* and udo_* field names. Unknown keys are rejected with 422. PATCH preserves omitted fields; required fields cannot be cleared with null or an empty multivalue list. Record references must resolve to active records of their configured target object in the same organization and app. */
   values?: Record<string, unknown>;
 }
+
+export interface RelatedRecordEdge {
+  can_unlink: boolean;
+  definition_id: string;
+  definition_revision: number;
+  id: string;
+  relationship_label: string;
+  source_kind: "custom" | "contacts" | "companies" | "deals";
+  source_label: string | null;
+  source_object_slug: string;
+  source_record_id: string;
+  source_revision: number;
+  target_kind: "custom" | "contacts" | "companies" | "deals";
+  target_label: string | null;
+  target_object_slug: string;
+  target_record_id: string;
+  target_revision: number;
+}
+
+export interface RelationshipCreate {
+  definition_id: string;
+  expected_definition_revision: number;
+  expected_source_revision: number;
+  expected_target_revision: number;
+  target_record_id: string;
+}
+
+export interface RelationshipDefinitionListResponse {
+  relationships: Array<RelationshipDefinitionResponse>;
+  total: number;
+}
+
+export interface RelationshipDefinitionResponse {
+  api_slug: string;
+  created_at: string;
+  id: string;
+  is_archived: boolean;
+  revision: number;
+  source_kind: string;
+  source_label: string;
+  source_many: boolean;
+  source_object_definition_id: string | null;
+  target_kind: string;
+  target_label: string;
+  target_many: boolean;
+  target_object_definition_id: string | null;
+}
+
+export interface RelationshipResponse {
+  definition_id: string;
+  id: string;
+  source_kind: string;
+  source_record_id: string;
+  source_revision: number;
+  target_kind: string;
+  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";