@graph8/sdk 0.264.0 → 0.277.0

package/docs/api/appointments.d.ts

@@ -1427,7 +1427,7 @@ export interface AppointmentsOperations {
   };
   /**
    * PATCH /appointments/bookings/{booking_uid}/location
-   * Update the meeting location and notify both parties
+   * Change a booking's location and/or conferencing
    * tier: external · scope: meetings:run
    */
   update_booking_location_appointments_bookings__booking_uid__location_patch: {
@@ -2028,10 +2028,16 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }
 
 export interface RequestRescheduleRequest {
@@ -2235,8 +2241,20 @@ export interface UpdateEventTypeRequest {
   use_common_schedule?: boolean | null;
 }
 
+/**
+ * Change a booking's location and/or conferencing.
+ *
+ * Send only the field you change: an omitted field is left as is, and ``null``
+ * clears it. ``selected_location`` is a physical, phone or custom location;
+ * ``selected_conferencing`` is a meeting link or a conferencing app (a new
+ * meeting room is created for zoom, roam_auto, ms_teams and google_meet).
+ * ``location`` is deprecated: a plain address, kept for older clients.
+ */
 export interface UpdateLocationRequest {
-  location: string;
+  location?: string | null;
+  notify_attendees?: boolean;
+  selected_conferencing?: LocationItem | null;
+  selected_location?: LocationItem | null;
 }
 
 /** A member's SCHEDULING role - not their graph8 organisation role. */

package/docs/api/appointments.md

@@ -100,7 +100,7 @@ Exact TypeScript types for every operation on this page, and every schema they u
 | [`toggleWorkflow`](#op-toggleworkflow) | `POST /api/v1/appointments/workflows/{workflow_id}/toggle` | external | `meetings:run` | Activate or deactivate a workflow |
 | [`unassignManagedMember`](#op-unassignmanagedmember) | `DELETE /api/v1/appointments/event-types/{event_type_id}/members/{user_id}` | destructive | `meetings:delete` | Unassign Managed Member |
 | [`updateAvailability`](#op-updateavailability) | `PATCH /api/v1/appointments/schedules/{schedule_id}/availability` | write | `meetings:write` | Replace availability rules and/or date overrides for a schedule |
-| [`updateBookingLocation`](#op-updatebookinglocation) | `PATCH /api/v1/appointments/bookings/{booking_uid}/location` | external | `meetings:run` | Update the meeting location and notify both parties |
+| [`updateBookingLocation`](#op-updatebookinglocation) | `PATCH /api/v1/appointments/bookings/{booking_uid}/location` | external | `meetings:run` | Change a booking's location and/or conferencing |
 | [`updateBookingSequence`](#op-updatebookingsequence) | `PATCH /api/v1/appointments/bookings/{booking_uid}/sequence` | external | `meetings:run` | Associate a booking with a sequence (or detach) |
 | [`updateEmbedConfig`](#op-updateembedconfig) | `PATCH /api/v1/appointments/event-types/{event_type_id}/embed` | write | `meetings:write` | Update Embed Config |
 | [`updateEventType`](#op-updateeventtype) | `PATCH /api/v1/appointments/event-types/{event_type_id}` | write | `meetings:write` | Update an event type (partial) |
@@ -145,7 +145,7 @@ Body fields (`AddGuestsRequest`):
 
 | Field | Type | Required | Description |
 |---|---|---|---|
-| `body.guests` | `Array<string>` | yes |  |
+| `body.guests` | `Array<string>` | yes | min items 1, max items 50 |
 
 **Returns** `Record<string, unknown>`.
 
@@ -3148,20 +3148,33 @@ const result = await g8.api.appointments.updateAvailability({ path: { schedule_i
 
 ### `g8.api.appointments.updateBookingLocation(input)`
 
-**Update the meeting location and notify both parties**
+**Change a booking's location and/or conferencing**
 
 - HTTP: `PATCH /api/v1/appointments/bookings/{booking_uid}/location`
 - operationId: `update_booking_location_appointments_bookings__booking_uid__location_patch` (also callable as `g8.api.call("update_booking_location_appointments_bookings__booking_uid__location_patch", input)`)
 - Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
 - API-key scope: `meetings:run`
 
-Change the meeting location for a booking and re-notify both parties.
+Change a booking's physical location and/or its conferencing.
 
-``location`` is a location key such as ``"zoom"``, ``"google_meet"``,
-``"in_person"``, or a custom URL.  Backed by
-``BookingsHandler.handle_update_location`` (updates the booking row,
-sends location-updated emails, emits an EDA event).  Raises 404 when
-the booking uid is not visible to the caller.
+Two independent fields; send only the one you change. An omitted field is
+left as is, and ``null`` clears it:
+
+* ``selected_location``: a location object, e.g.
+  ``{"kind": "in_person_host", "address": "1 Market St"}``,
+  ``{"kind": "phone_host", "phone": "+14155550100"}`` or
+  ``{"kind": "custom", "display_label": "Lobby"}``.
+* ``selected_conferencing``: ``{"kind": "link", "link": "https://..."}`` for a
+  meeting URL, or ``{"kind": "conferencing", "provider": "zoom"}`` (also
+  ``roam_auto``, ``ms_teams``, ``google_meet``), which creates a NEW meeting room.
+* ``notify_attendees`` (default true): the host is always emailed.
+
+The host's calendar event is updated too; ``calendar_synced`` in the response
+is false when that update failed (the change is saved either way). Errors:
+404 when the booking is not visible to the caller, 409 when it is cancelled,
+past, imported or changed meanwhile, 422 for an invalid value or a provider
+the host has not connected, 429 past the per-booking edit limit, 502 when a
+new meeting room could not be created (nothing is changed then).
 
 **Input**
 
@@ -3174,7 +3187,10 @@ Body fields (`UpdateLocationRequest`):
 
 | Field | Type | Required | Description |
 |---|---|---|---|
-| `body.location` | `string` | yes |  |
+| `body.location` | `string \| null` | no |  |
+| `body.notify_attendees` | `boolean` | no | default `true` |
+| `body.selected_conferencing` | `LocationItem \| null` | no |  |
+| `body.selected_location` | `LocationItem \| null` | no |  |
 
 **Returns** `Record<string, unknown>`.
 
@@ -3182,7 +3198,7 @@ Body fields (`UpdateLocationRequest`):
 
 ```ts
 // external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
-const result = await g8.api.appointments.updateBookingLocation({ path: { booking_uid: "example" }, body: { location: "example" } });
+const result = await g8.api.appointments.updateBookingLocation({ path: { booking_uid: "example" }, body: {} });
 ```
 
 ---

package/docs/api/apps.d.ts

@@ -713,10 +713,16 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }
 
 /**

package/docs/api/apps.md

@@ -504,11 +504,13 @@ Can this app be built and run yet, and if not, what is missing (M9 J9).
 
 ANSWERS FROM THE CONTROL PLANE, AND SAYS SO. It reports what graph8 has
 recorded: a bound source, an assigned hostname, declared secrets, the last
-deployment's state. It does NOT claim the cluster side is ready, because the
-namespace provisioner, the image registry and the runtime objects are
-separate, unbuilt work. Reporting `ready: true` on that basis would be the
-most expensive kind of wrong: a builder would push and wait for something
-nothing can serve.
+deployment's state. The serving half -- namespace provisioner, registry
+credentials, and the deployed-image rollout -- now EXISTS as control-plane code
+(#22301), so this no longer blocks on it unconditionally. What it still checks
+is whether that code is CONFIGURED in this environment (`_unset_serving_runtime_vars`):
+reporting `ready: true` with the templates or registry credentials unset would
+be the most expensive kind of wrong, because a builder would push and wait for
+something nothing can serve.
 
 `blockers` is the field that matters. An agent driving a build needs to know
 WHY it cannot proceed; a bare `ready: false` sends it guessing, and guessing

package/docs/api/assertUpsert.d.ts

@@ -146,6 +146,8 @@ export interface BatchAssertResponse {
   errors?: Array<Record<string, unknown>>;
   total: number;
   updated?: number;
+  /** Advisory notes about values saved as sent that look wrong (e.g. an unrecognised seniority or country), prefixed with the row index. Empty when the input is clean. */
+  warnings?: Array<string>;
 }
 
 export interface BatchCompanyAssertRequest {
@@ -193,6 +195,8 @@ export interface CompanyAssertResponse {
   action: string;
   count?: number;
   custom_fields?: CustomFieldWriteReport;
+  /** Advisory notes about values saved as sent that look wrong (e.g. an unrecognised country). Empty when the input is clean. */
+  warnings?: Array<string>;
 }
 
 export interface ContactAssertRequest {
@@ -225,6 +229,8 @@ export interface ContactAssertResponse {
   action: string;
   count?: number;
   custom_fields?: CustomFieldWriteReport;
+  /** Advisory notes about values saved as sent that look wrong (e.g. an unrecognised seniority or country). Empty when the input is clean. */
+  warnings?: Array<string>;
 }
 
 /**
@@ -279,8 +285,14 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }

package/docs/api/assertUpsert.md

@@ -71,6 +71,7 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `custom_fields` | `CustomFieldWriteReport` | no |  |
 | `errors` | `Array<Record<string, unknown>>` | no | default `[]` |
 | `updated` | `integer` | no | default `0` |
+| `warnings` | `Array<string>` | no | Advisory notes about values saved as sent that look wrong (e.g. an unrecognised seniority or country), prefixed with the row index. Empty when the input is clean. |
 
 **Example**
 
@@ -129,6 +130,7 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `action` | `string` | yes | 'created' or 'updated' |
 | `count` | `integer` | no | default `1` |
 | `custom_fields` | `CustomFieldWriteReport` | no |  |
+| `warnings` | `Array<string>` | no | Advisory notes about values saved as sent that look wrong (e.g. an unrecognised country). Empty when the input is clean. |
 
 **Example**
 
@@ -191,6 +193,7 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `action` | `string` | yes | 'created' or 'updated' |
 | `count` | `integer` | no | default `1` |
 | `custom_fields` | `CustomFieldWriteReport` | no |  |
+| `warnings` | `Array<string>` | no | Advisory notes about values saved as sent that look wrong (e.g. an unrecognised seniority or country). Empty when the input is clean. |
 
 **Example**
 
@@ -240,6 +243,7 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `custom_fields` | `CustomFieldWriteReport` | no |  |
 | `errors` | `Array<Record<string, unknown>>` | no | default `[]` |
 | `updated` | `integer` | no | default `0` |
+| `warnings` | `Array<string>` | no | Advisory notes about values saved as sent that look wrong (e.g. an unrecognised seniority or country), prefixed with the row index. Empty when the input is clean. |
 
 **Example**
 

package/docs/api/audienceSyncs.d.ts

@@ -234,10 +234,16 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }
 
 export interface SyncErrorResponse {

package/docs/api/brandKit.d.ts

@@ -593,10 +593,16 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }
 
 /**

package/docs/api/bugReports.d.ts

@@ -174,8 +174,14 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }

package/docs/api/by-path.md

@@ -2367,6 +2367,7 @@ Every Developer API route, sorted by path, with the SDK call that reaches it. Th
 | GET | `/api/v1/roles` | [`g8.api.roles.listRoles`](roles.md#op-listroles) | read |
 | POST | `/api/v1/roles` | [`g8.api.roles.createRole`](roles.md#op-createrole) | write |
 | GET | `/api/v1/roles/domain-settings` | [`g8.api.roles.getDomainSettings`](roles.md#op-getdomainsettings) | read |
+| POST | `/api/v1/roles/invite` | [`g8.api.roles.inviteMember`](roles.md#op-invitemember) | external |
 | GET | `/api/v1/roles/join-requests` | [`g8.api.roles.listJoinRequests`](roles.md#op-listjoinrequests) | read |
 | GET | `/api/v1/roles/join-requests/count` | [`g8.api.roles.getJoinRequestCount`](roles.md#op-getjoinrequestcount) | read |
 | POST | `/api/v1/roles/join-requests/{request_id}/reject` | [`g8.api.roles.rejectJoinRequest`](roles.md#op-rejectjoinrequest) | write |

package/docs/api/calendarInvites.d.ts

@@ -110,8 +110,14 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }

package/docs/api/campaignWorkflows.d.ts

@@ -145,8 +145,14 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }

package/docs/api/campaigns.d.ts

@@ -674,10 +674,16 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }
 
 /**

package/docs/api/channels.d.ts

@@ -151,10 +151,16 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }
 
 /**

package/docs/api/cliCampaigns.d.ts

@@ -164,10 +164,16 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }
 
 export interface developer_api__interfaces__v1__cli_campaigns_router__CampaignCreateRequest {

package/docs/api/cliPipelines.d.ts

@@ -256,10 +256,16 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }
 
 export interface PipelineCreateRequest {

package/docs/api/clickHouse.d.ts

@@ -108,8 +108,14 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }

package/docs/api/companies.d.ts

@@ -633,9 +633,9 @@ export interface CompaniesOperations {
       employee_count_min?: number | null;
       /** Maximum employee count */
       employee_count_max?: number | null;
-      /** Filter by country (exact match) */
+      /** Filter by country (exact match, case-insensitive; surrounding spaces ignored). Common aliases match each other: United States = US = USA; United Kingdom = UK. */
       country?: string | null;
-      /** Filter by state (exact match) */
+      /** Filter by state (exact match, case-insensitive; surrounding spaces ignored) */
       state?: string | null;
       /** Filter by city (partial match) */
       city?: string | null;
@@ -1204,6 +1204,8 @@ export interface CompanyCreateResponse {
   company_id?: number | null;
   merged?: boolean;
   status: string;
+  /** Advisory notes about values that look wrong (e.g. an employee_count with no number, an unrecognised country, or a linkedin_url that is not a web address and was not saved). Empty when the input is clean. */
+  warnings?: Array<string>;
 }
 
 /** Lighter company representation for list endpoints. */
@@ -1526,10 +1528,16 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }
 
 /** Attach the output of a skill run to a record as a document. */

package/docs/api/companies.md

@@ -297,6 +297,7 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `status` | `string` | yes |  |
 | `company_id` | `integer \| null` | no |  |
 | `merged` | `boolean` | no | default `false` |
+| `warnings` | `Array<string>` | no | Advisory notes about values that look wrong (e.g. an employee_count with no number, an unrecognised country, or a linkedin_url that is not a web address and was not saved). Empty when the input is clean. |
 
 **Example**
 
@@ -1354,8 +1355,8 @@ List companies with optional filtering and pagination.
 | `query.name` | `string \| null` | no | Filter by company name (partial match) |
 | `query.employee_count_min` | `integer \| null` | no | Minimum employee count |
 | `query.employee_count_max` | `integer \| null` | no | Maximum employee count |
-| `query.country` | `string \| null` | no | Filter by country (exact match) |
-| `query.state` | `string \| null` | no | Filter by state (exact match) |
+| `query.country` | `string \| null` | no | Filter by country (exact match, case-insensitive; surrounding spaces ignored). Common aliases match each other: United States = US = USA; United Kingdom = UK. |
+| `query.state` | `string \| null` | no | Filter by state (exact match, case-insensitive; surrounding spaces ignored) |
 | `query.city` | `string \| null` | no | Filter by city (partial match) |
 | `query.description` | `string \| null` | no | Filter by company description (partial match) |
 | `query.revenue_min` | `integer \| null` | no | Minimum annual revenue |
@@ -2068,6 +2069,12 @@ const result = await g8.api.companies.startCompanyWorkflow({ path: { company_id:
 
 Update a company's fields (partial update).
 
+A ``name`` over 512 characters or a ``linkedin_url`` that is not a web
+address is refused with a 400 and nothing is written. An employee_count
+with no number, an unrecognised country, or a linkedin_url that is not on
+linkedin.com is saved as sent and flagged in ``warnings`` (present only
+when there is something to flag).
+
 **Input**
 
 | Field | Type | Required | Description |

package/docs/api/companyIntelligence.d.ts

@@ -292,8 +292,14 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }

package/docs/api/contacts.d.ts

@@ -844,7 +844,7 @@ export interface ContactsOperations {
       page?: number;
       /** Items per page (max 200) */
       limit?: number;
-      /** Filter by work email (exact match) */
+      /** Filter by work email (exact match, case-insensitive; surrounding spaces ignored) */
       email?: string | null;
       /** Filter by list ID */
       list_id?: number | null;
@@ -852,15 +852,15 @@ export interface ContactsOperations {
       name?: string | null;
       /** Filter by job title (partial match) */
       job_title?: string | null;
-      /** Filter by seniority level (exact match) */
+      /** Filter by seniority level (exact match, case-insensitive). Spellings of the same level match each other: VP = Vice President; SVP/EVP = SVP = EVP = Senior/Executive Vice President; C-Suite = C-Level = CXO. Pass several levels comma-separated to match any of them, e.g. `VP,SVP/EVP`. */
       seniority_level?: string | null;
       /** Filter by company name (partial match) */
       company_name?: string | null;
       /** Filter by company ID */
       company_id?: number | null;
-      /** Filter by country (exact match) */
+      /** Filter by country (exact match, case-insensitive; surrounding spaces ignored). Common aliases match each other: United States = US = USA; United Kingdom = UK. */
       country?: string | null;
-      /** Filter by state (exact match) */
+      /** Filter by state (exact match, case-insensitive; surrounding spaces ignored) */
       state?: string | null;
       /** Filter by city (partial match) */
       city?: string | null;
@@ -1540,6 +1540,8 @@ export interface ContactCreateResponse {
   merged?: boolean;
   status: string;
   validation_errors?: Array<string>;
+  /** Advisory notes about values saved as sent that look wrong (e.g. an unrecognised seniority or country). Empty when the input is clean. */
+  warnings?: Array<string>;
 }
 
 /** Mirrors `campaign_builder.models.contact_documents.UpdateContactDocumentRequest`. */
@@ -1553,8 +1555,14 @@ export interface ContactDocumentUpdateRequest {
 /** Lighter contact representation for list endpoints. */
 export interface ContactListItem {
   city?: string | null;
+  company_domain?: string | null;
+  company_employee_count?: string | null;
   company_id?: number | null;
+  company_industry?: string | null;
+  company_name?: string | null;
+  company_website?: string | null;
   country?: string | null;
+  created_at?: string | null;
   custom_fields?: (Record<string, string | null>) | null;
   direct_phone?: string | null;
   first_name?: string | null;
@@ -1568,6 +1576,7 @@ export interface ContactListItem {
   owner_name?: string | null;
   seniority_level?: string | null;
   state?: string | null;
+  updated_at?: string | null;
   work_email?: string | null;
 }
 
@@ -1930,10 +1939,16 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }
 
 /**