@graph8/sdk 0.265.0 → 0.293.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 {
@@ -191,8 +193,12 @@ export interface CompanyAssertRequest {
 export interface CompanyAssertResponse {
   /** 'created' or 'updated' */
   action: string;
+  /** ID of the company that was created or updated (use it with GET/PATCH /companies/{company_id}). Null when the saved record cannot be identified unambiguously, e.g. when the domain already matched several companies in the list. */
+  company_id?: number | null;
   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 +231,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 +287,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**
 
@@ -127,8 +128,10 @@ Other envelope fields: `pagination` (PaginationMeta).
 | Field | Type | Required | Description |
 |---|---|---|---|
 | `action` | `string` | yes | 'created' or 'updated' |
+| `company_id` | `integer \| null` | no | ID of the company that was created or updated (use it with GET/PATCH /companies/{company_id}). Null when the saved record cannot be identified unambiguously, e.g. when the domain already matched several companies in the list. |
 | `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 +194,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 +244,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

@@ -198,11 +198,19 @@ export interface AudienceSyncConfigResponse {
   id: number;
   is_active?: boolean;
   last_sync_at?: string | null;
+  /** Error of the last failed run, if any. */
+  last_sync_error?: string | null;
   mode?: string;
+  /** When the worker will next try this sync. */
+  next_sync_at?: string | null;
   platform: string;
   platform_audience_name?: string | null;
   refresh_cadence_hours?: number;
   status?: string | null;
+  /** Human-readable explanation of status_reason. */
+  status_detail?: string | null;
+  /** Why the sync is not delivering, or null when healthy: keyword_only (no list, keyword-only Google Search; never scheduled), list_missing (every list it uploads from was deleted), lists_partially_missing, paused, failing (last run failed), failing_never_synced (has never succeeded). */
+  status_reason?: string | null;
 }
 
 export interface AudienceSyncCreateRequest {
@@ -234,10 +242,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/audienceSyncs.md

@@ -79,10 +79,14 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `created_at` | `string \| null` | no |  |
 | `is_active` | `boolean` | no | default `true` |
 | `last_sync_at` | `string \| null` | no |  |
+| `last_sync_error` | `string \| null` | no | Error of the last failed run, if any. |
 | `mode` | `string` | no | default `"mirror"` |
+| `next_sync_at` | `string \| null` | no | When the worker will next try this sync. |
 | `platform_audience_name` | `string \| null` | no |  |
 | `refresh_cadence_hours` | `integer` | no | default `24` |
 | `status` | `string \| null` | no |  |
+| `status_detail` | `string \| null` | no | Human-readable explanation of status_reason. |
+| `status_reason` | `string \| null` | no | Why the sync is not delivering, or null when healthy: keyword_only (no list, keyword-only Google Search; never scheduled), list_missing (every list it uploads from was deleted), lists_partially_missing, paused, failing (last run failed), failing_never_synced (has never succeeded). |
 
 **Example**
 
@@ -160,10 +164,14 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `created_at` | `string \| null` | no |  |
 | `is_active` | `boolean` | no | default `true` |
 | `last_sync_at` | `string \| null` | no |  |
+| `last_sync_error` | `string \| null` | no | Error of the last failed run, if any. |
 | `mode` | `string` | no | default `"mirror"` |
+| `next_sync_at` | `string \| null` | no | When the worker will next try this sync. |
 | `platform_audience_name` | `string \| null` | no |  |
 | `refresh_cadence_hours` | `integer` | no | default `24` |
 | `status` | `string \| null` | no |  |
+| `status_detail` | `string \| null` | no | Human-readable explanation of status_reason. |
+| `status_reason` | `string \| null` | no | Why the sync is not delivering, or null when healthy: keyword_only (no list, keyword-only Google Search; never scheduled), list_missing (every list it uploads from was deleted), lists_partially_missing, paused, failing (last run failed), failing_never_synced (has never succeeded). |
 
 **Example**
 
@@ -203,10 +211,14 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `created_at` | `string \| null` | no |  |
 | `is_active` | `boolean` | no | default `true` |
 | `last_sync_at` | `string \| null` | no |  |
+| `last_sync_error` | `string \| null` | no | Error of the last failed run, if any. |
 | `mode` | `string` | no | default `"mirror"` |
+| `next_sync_at` | `string \| null` | no | When the worker will next try this sync. |
 | `platform_audience_name` | `string \| null` | no |  |
 | `refresh_cadence_hours` | `integer` | no | default `24` |
 | `status` | `string \| null` | no |  |
+| `status_detail` | `string \| null` | no | Human-readable explanation of status_reason. |
+| `status_reason` | `string \| null` | no | Why the sync is not delivering, or null when healthy: keyword_only (no list, keyword-only Google Search; never scheduled), list_missing (every list it uploads from was deleted), lists_partially_missing, paused, failing (last run failed), failing_never_synced (has never succeeded). |
 
 **Example**
 
@@ -382,10 +394,14 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `created_at` | `string \| null` | no |  |
 | `is_active` | `boolean` | no | default `true` |
 | `last_sync_at` | `string \| null` | no |  |
+| `last_sync_error` | `string \| null` | no | Error of the last failed run, if any. |
 | `mode` | `string` | no | default `"mirror"` |
+| `next_sync_at` | `string \| null` | no | When the worker will next try this sync. |
 | `platform_audience_name` | `string \| null` | no |  |
 | `refresh_cadence_hours` | `integer` | no | default `24` |
 | `status` | `string \| null` | no |  |
+| `status_detail` | `string \| null` | no | Human-readable explanation of status_reason. |
+| `status_reason` | `string \| null` | no | Why the sync is not delivering, or null when healthy: keyword_only (no list, keyword-only Google Search; never scheduled), list_missing (every list it uploads from was deleted), lists_partially_missing, paused, failing (last run failed), failing_never_synced (has never succeeded). |
 
 **Example**
 

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

@@ -1183,6 +1183,7 @@ Every Developer API route, sorted by path, with the SDK call that reaches it. Th
 | POST | `/api/v1/enrichment/lookup/company` | [`g8.api.enrichment.lookupCompany`](enrichment.md#op-lookupcompany) or `g8.enrich.company()` | billable |
 | POST | `/api/v1/enrichment/lookup/person` | [`g8.api.enrichment.lookupPerson`](enrichment.md#op-lookupperson) or `g8.enrich.person()` | billable |
 | POST | `/api/v1/enrichment/person` | [`g8.api.enrichment.lookupPersonAlias`](enrichment.md#op-lookuppersonalias) | billable |
+| POST | `/api/v1/enrichment/preflight` | [`g8.api.enrichment.preflightEnrichment`](enrichment.md#op-preflightenrichment) | read |
 | GET | `/api/v1/enrichment/providers` | [`g8.api.enrichment.listEnrichmentProviders`](enrichment.md#op-listenrichmentproviders) | read |
 | GET | `/api/v1/enrichment/record-sync/{entity_type}/fields` | [`g8.api.enrichment.listRecordSyncFields`](enrichment.md#op-listrecordsyncfields) | read |
 | GET | `/api/v1/enrichment/record-sync/{entity_type}/history` | [`g8.api.enrichment.listRecordSyncHistory`](enrichment.md#op-listrecordsynchistory) | read |
@@ -2367,6 +2368,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 |
@@ -2652,6 +2654,7 @@ Every Developer API route, sorted by path, with the SDK call that reaches it. Th
 | POST | `/api/v1/social/posts/{post_id}/publish` | [`g8.api.socialPublishing.publishSocialPost`](socialPublishing.md#op-publishsocialpost) | external |
 | POST | `/api/v1/social/posts/{post_id}/schedule` | [`g8.api.socialPublishing.scheduleSocialPost`](socialPublishing.md#op-schedulesocialpost) | external |
 | GET | `/api/v1/social/providers` | [`g8.api.socialPublishing.listSocialProviders`](socialPublishing.md#op-listsocialproviders) | read |
+| GET | `/api/v1/streams` | [`g8.api.snippet.listOrgStreams`](snippet.md#op-listorgstreams) | read |
 | POST | `/api/v1/stripe/api-key` | [`g8.api.quotes.connectStripeApiKey`](quotes.md#op-connectstripeapikey) | external |
 | GET | `/api/v1/stripe/companies/{company_id}/invoices` | [`g8.api.quotes.getCompanyStripeInvoices`](quotes.md#op-getcompanystripeinvoices) | read |
 | GET | `/api/v1/stripe/companies/{company_id}/revenue-summary` | [`g8.api.quotes.getCompanyRevenueSummary`](quotes.md#op-getcompanyrevenuesummary) | read |

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. */
@@ -1318,7 +1320,7 @@ export type CompanyWorkflowType = "company_intelligence" | "stakeholder_mapping"
 export interface CreateCompanyColumnRequest {
   /** Email of the user creating the column (for audit). */
   created_by: string;
-  /** Column data type. Currently only 'text' is supported. */
+  /** Column data type: 'text', 'int' (whole number), 'numeric' (decimal) or 'boolean' (yes/no). Other values 422. */
   data_type?: ColumnType;
   /** STRONGLY RECOMMENDED. Optional waterfall enrichment block. When supplied, a companion `enrichment_configs` row is created alongside the column so the UI 'Enrich' button works immediately. Without it the column exists but isn't enrichable until a pipeline is configured via POST /enrichment/waterfall/configs. */
   enrichment?: CreateFieldEnrichmentInput | null;
@@ -1337,15 +1339,21 @@ export interface CreateCompanyColumnRequest {
  * that is populated when the request included an `enrichment` block.
  */
 export interface CreateCompanyColumnResponse {
+  /** True when a column with this name already existed in this scope, so the existing column was returned. A different `data_type` is rejected with 409. */
+  already_existed?: boolean;
   data_type?: ColumnType;
   /** Populated when the request included an `enrichment` block. Use `enrichment.column_id` for subsequent POST /enrichment/waterfall/enrich calls. */
   enrichment?: CreateFieldEnrichmentResponse | null;
+  /** When `already_existed` is true: the existing column's data type. */
+  existing_data_type?: string | null;
   id?: number | null;
   /** Computed: True when object_id is null/empty (global column). */
   is_global?: boolean;
   name?: string | null;
   object_id?: string | null;
   title: string;
+  /** Non-blocking notices (e.g. a same-named org-wide column also shows on this list). */
+  warnings?: Array<string>;
 }
 
 /**
@@ -1526,10 +1534,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. */