@graph8/sdk 0.238.0 → 0.245.0

package/dist/index.js

@@ -332,6 +332,662 @@ var createCalendarClient = (apiUrl) => {
   };
 };
 
+// src/generated/billable.ts
+var BILLABLE_ROUTES = {
+  GET: [
+    "/apps/{app_id}/runtime",
+    "/audience-syncs/{config_id}/runs",
+    "/campaigns/{campaign_id}/dashboard",
+    "/companies/{company_id}/next-best-step",
+    "/contacts/{contact_id}/next-best-step",
+    "/desk/kickoff",
+    "/desk/kickoff/audio",
+    "/radar/competitors/{competitor_id}/discover-pages",
+    "/repos/{repo_id}/scan",
+    "/seo/domains/{domain}/backlinks",
+    "/seo/domains/{domain}/overview",
+    "/voice/campaigns/call-scripts",
+    "/voice/campaigns/email-templates",
+    "/voice/campaigns/templates",
+    "/voice/research/business-data",
+    "/voice/research/competitors",
+    "/voice/research/faq",
+    "/voice/research/keywords",
+    "/voice/research/prospect-company",
+    "/work/routines/{routine_id}/runs"
+  ],
+  PATCH: [
+    "/enrichment/auto-enrichment/configs/{config_id}",
+    "/intent/keywords/{keyword_id}",
+    "/intent/keywords/{keyword_id}/sync-config",
+    "/marketplace/agencies/{slug}",
+    "/marketplace/agencies/{slug}/reps/{sdr_id}",
+    "/marketplace/agencies/{slug}/service-statements/{statement_id}",
+    "/marketplace/applications/{application_id}",
+    "/marketplace/conversations/{conversation_id}/state",
+    "/marketplace/job-posts/{post_id}",
+    "/marketplace/me/meetings/{meeting_id}",
+    "/marketplace/me/messages/{conversation_id}/state",
+    "/marketplace/me/profile",
+    "/marketplace/me/service-statements/{statement_id}",
+    "/marketplace/org/meetings/{meeting_id}",
+    "/radar/competitors/{competitor_id}",
+    "/radar/gaps/{gap_id}",
+    "/research-reports/{report_id}",
+    "/social-listeners/settings",
+    "/social-listeners/{listener_id}"
+  ],
+  POST: [
+    "/accounts/{account_id}/generate-outreach-plan",
+    "/accounts/{account_id}/security-questionnaires",
+    "/accounts/{account_id}/stakeholders/{stakeholder_id}/generate-outreach",
+    "/ad-creatives",
+    "/ad-creatives/batch",
+    "/ad-creatives/concepts",
+    "/ad-creatives/video/clips",
+    "/ad-creatives/video/clips/prompt-enhance",
+    "/ad-creatives/video/clips/{clip_id}/continue",
+    "/ad-creatives/video/clips/{clip_id}/extend",
+    "/ad-creatives/video/clips/{clip_id}/regenerate",
+    "/ad-creatives/{creative_id}/ai-review",
+    "/ad-creatives/{creative_id}/chat-edit",
+    "/ad-creatives/{creative_id}/image-edit-at-point",
+    "/ad-creatives/{creative_id}/persona-lens",
+    "/ad-creatives/{creative_id}/regenerate-copy",
+    "/ad-creatives/{creative_id}/regenerate-image",
+    "/ad-creatives/{creative_id}/retry",
+    "/ad-creatives/{creative_id}/rewrite-field",
+    "/ad-creatives/{creative_id}/size-set",
+    "/agent/chat",
+    "/agent/onboarding/discovery/turn",
+    "/agent/operators/{operator}/approvals/{task_id}/decide",
+    "/agent/sessions/{session_id}/voice",
+    "/agent/work-items",
+    "/app-pages/{page_id}/generate",
+    "/campaigns/generate-ideas",
+    "/campaigns/generate-ideas-async",
+    "/campaigns/recommend-personas",
+    "/campaigns/{campaign_id}/audience-pipeline/accept-filters",
+    "/campaigns/{campaign_id}/audience-pipeline/trigger",
+    "/campaigns/{campaign_id}/documents/{document_id}/regenerate",
+    "/campaigns/{campaign_id}/sequence/steps/{step_id}/generate",
+    "/companies/enrich/bulk",
+    "/companies/enrich/people/bulk",
+    "/companies/enrich/stakeholders/bulk",
+    "/companies/import",
+    "/companies/{company_id}/documents/types/{doc_type}/generate",
+    "/companies/{company_id}/documents/types/{doc_type}/regenerate",
+    "/companies/{company_id}/enrich",
+    "/companies/{company_id}/retry-intelligence",
+    "/companies/{company_id}/retry-synthesis",
+    "/companies/{company_id}/workflows/{workflow_type}/start",
+    "/company-profile/generate",
+    "/company-profile/reindex",
+    "/company-profile/retry",
+    "/contacts/unlock-info",
+    "/contacts/verify-email",
+    "/contacts/verify-email/async",
+    "/contacts/workflow-executions/run",
+    "/contacts/{contact_id}/documents/generate-all",
+    "/contacts/{contact_id}/documents/types/{doc_type}/generate",
+    "/contacts/{contact_id}/documents/types/{doc_type}/regenerate",
+    "/content-workspace/import/crawl",
+    "/content/calendar/ideas/{idea_id}/create-content",
+    "/content/calendar/mine-signals",
+    "/content/calendar/repurpose/ad",
+    "/content/calendar/repurpose/linkedin-post",
+    "/content/grids/{grid_id}/columns/{column_id}/run",
+    "/content/grids/{grid_id}/rows/{row_id}/run/{column_id}",
+    "/content/pages/enrich-seo-bulk",
+    "/content/pages/{page_id}/enrich-seo",
+    "/copilot/chat",
+    "/copilot/landing-page-action",
+    "/copilot/memory/promote",
+    "/customer-success/companies/{company_id}/brief/synthesize",
+    "/deals/{deal_id}/documents/generate-all",
+    "/deals/{deal_id}/documents/types/{doc_type}/generate",
+    "/deals/{deal_id}/documents/types/{doc_type}/regenerate",
+    "/deals/{deal_id}/next-best-step",
+    "/desk/accounts/{account_id}/committee/{contact_id}/find-linkedin",
+    "/desk/accounts/{account_id}/plan/draft",
+    "/desk/ask",
+    "/desk/decisions/{decision_id}/replan",
+    "/desk/email-improve",
+    "/desk/email-score",
+    "/desk/org-settings/plan-stages/run",
+    "/desk/voice-memo",
+    "/dialer/parallel-calls/grading/backfill",
+    "/dialer/sessions/prewarm-voicemails",
+    "/enrichment/ai-formula/generate",
+    "/enrichment/ai-formula/generate-condition",
+    "/enrichment/ai/batch/enrich",
+    "/enrichment/ai/enrich",
+    "/enrichment/ai/qualification/generate-templates",
+    "/enrichment/ai/qualification/run",
+    "/enrichment/auto-enrichment/configs",
+    "/enrichment/enrich",
+    "/enrichment/find-people/configure",
+    "/enrichment/find-people/search-import",
+    "/enrichment/find-people/{config_id}/import",
+    "/enrichment/find-people/{config_id}/preview",
+    "/enrichment/find-people/{config_id}/run",
+    "/enrichment/generate-prompt",
+    "/enrichment/jobs/{job_id}/resume",
+    "/enrichment/list-routing/generate-filter",
+    "/enrichment/lists/{list_id}/pipelines",
+    "/enrichment/lists/{list_id}/pipelines/ai-draft",
+    "/enrichment/lists/{list_id}/pipelines/{pipeline_id}/enabled",
+    "/enrichment/lists/{list_id}/pipelines/{pipeline_id}/runs",
+    "/enrichment/lookup/company",
+    "/enrichment/lookup/person",
+    "/enrichment/record-sync/{entity_type}/run",
+    "/enrichment/verify-email",
+    "/enrichment/waterfall/configs",
+    "/enrichment/waterfall/enrich",
+    "/global-context/generate-all",
+    "/global-context/generate/{doc_type}",
+    "/hiring-signals/aggregators",
+    "/hiring-signals/companies",
+    "/hiring-signals/companies/job-counts",
+    "/hiring-signals/companies/resolve-ids",
+    "/hiring-signals/decision-makers",
+    "/hiring-signals/job-changes/match",
+    "/hiring-signals/jobs",
+    "/hiring-signals/recruiters",
+    "/icps/generate",
+    "/inbox/drafts/generate",
+    "/intelligence/analyze",
+    "/intelligence/retry",
+    "/intent/contacts/metadata",
+    "/intent/keywords/add",
+    "/intent/keywords/auto-seed-proposals",
+    "/intent/keywords/create-from-domain",
+    "/intent/keywords/create-from-search",
+    "/intent/keywords/list",
+    "/intent/keywords/{keyword_id}/companies",
+    "/intent/keywords/{keyword_id}/contacts",
+    "/intent/keywords/{keyword_id}/filters",
+    "/intent/keywords/{keyword_id}/job-resolution",
+    "/intent/keywords/{keyword_id}/sync",
+    "/intent/keywords/{keyword_id}/urls",
+    "/intent/pages-by-domain",
+    "/intent/pages/contacts",
+    "/intent/pages/search",
+    "/intent/pages/visitor-counts",
+    "/intent/pages/visitors",
+    "/landing-pages",
+    "/landing-pages/clone-homepage",
+    "/landing-pages/clone-html",
+    "/landing-pages/clone-url",
+    "/landing-pages/components/extract",
+    "/landing-pages/ensure-base-template",
+    "/landing-pages/{landing_page_id}/ai-review",
+    "/landing-pages/{landing_page_id}/ai-review/fix-with-ai",
+    "/landing-pages/{landing_page_id}/edit",
+    "/landing-pages/{landing_page_id}/edit-element",
+    "/landing-pages/{landing_page_id}/edit-page",
+    "/landing-pages/{landing_page_id}/generate-seo-metadata",
+    "/landing-pages/{landing_page_id}/rewrite-text",
+    "/leads/generate-content/batches",
+    "/leads/{lead_id}/generate-content",
+    "/library/case-studies/backfill",
+    "/lifecycle-contacts/unlock",
+    "/mailboxes/schedule-buy/plans",
+    "/mailboxes/schedule-buy/plans/{plan_id}/resume",
+    "/mailboxes/uncancel",
+    "/mailboxes/{mailbox_id}/health/placement-test",
+    "/marketplace/agencies/{slug}/intake/upload",
+    "/marketplace/agencies/{slug}/reps/{sdr_id}/unlist",
+    "/marketplace/agencies/{slug}/reps/{sdr_id}/video-intro",
+    "/marketplace/agencies/{slug}/service-statements",
+    "/marketplace/agencies/{slug}/service-statements/{statement_id}/line-items",
+    "/marketplace/agencies/{slug}/service-statements/{statement_id}/submit",
+    "/marketplace/commissions/entries",
+    "/marketplace/commissions/entries/{entry_id}/quality",
+    "/marketplace/commissions/entries/{entry_id}/reversals",
+    "/marketplace/commissions/entries/{entry_id}/statement",
+    "/marketplace/commissions/plans",
+    "/marketplace/commissions/plans/{version_id}/activate",
+    "/marketplace/commissions/preview",
+    "/marketplace/conversations/{conversation_id}/read",
+    "/marketplace/job-posts",
+    "/marketplace/job-posts/{post_id}/jd",
+    "/marketplace/me/headshot",
+    "/marketplace/me/invoices",
+    "/marketplace/me/invoices/{invoice_id}/approve",
+    "/marketplace/me/messages/{conversation_id}/read",
+    "/marketplace/me/offers/{hiring_id}/accept",
+    "/marketplace/me/offers/{hiring_id}/reject",
+    "/marketplace/me/payout-account/w8-certify",
+    "/marketplace/me/resume",
+    "/marketplace/me/service-statements",
+    "/marketplace/me/service-statements/{statement_id}/line-items",
+    "/marketplace/me/service-statements/{statement_id}/revise",
+    "/marketplace/me/service-statements/{statement_id}/submit",
+    "/marketplace/me/video-intro",
+    "/marketplace/me/work-certificates",
+    "/marketplace/opportunities/{post_id}/apply",
+    "/marketplace/org/hirings/{hiring_id}/meetings",
+    "/marketplace/org/hirings/{hiring_id}/terminate",
+    "/marketplace/org/hirings/{hiring_id}/withdraw",
+    "/marketplace/org/invoices/{invoice_id}/approve",
+    "/marketplace/org/invoices/{invoice_id}/dispute",
+    "/marketplace/org/service-statements/{statement_id}/approve",
+    "/marketplace/org/service-statements/{statement_id}/line-items",
+    "/marketplace/org/service-statements/{statement_id}/reject",
+    "/marketplace/org/service-statements/{statement_id}/request-changes",
+    "/marketplace/shortlist/export",
+    "/marketplace/talent/{sdr_id}/hire",
+    "/marketplace/talent/{sdr_id}/match/analyze",
+    "/marketplace/talent/{sdr_id}/match/refresh",
+    "/marketplace/terms-acknowledgements/ack-all",
+    "/meeting-transcripts/{transcript_id}/follow-up-draft",
+    "/meeting-transcripts/{transcript_id}/review/regenerate",
+    "/newsletters/templates/clone",
+    "/newsletters/templates/custom",
+    "/newsletters/templates/layout",
+    "/newsletters/{newsletter_id}/issues/{issue_id}/generate",
+    "/newsletters/{newsletter_id}/issues/{issue_id}/rewrite-text",
+    "/newsletters/{newsletter_id}/subscribers/import-audience",
+    "/newsletters/{newsletter_id}/subscribers/verify",
+    "/org-videos/generate",
+    "/org/brand-snapshot/refresh",
+    "/personas/generate",
+    "/phone-numbers/purchase",
+    "/pipelines/suggest",
+    "/placement/tests",
+    "/provider-domains/add-external",
+    "/provider-domains/check-availability",
+    "/provider-domains/checkout-purchase",
+    "/provider-domains/checkout-transfer",
+    "/provider-domains/{domain_id}/auto-warmup",
+    "/provider-domains/{domain_id}/check-propagation",
+    "/provider-domains/{domain_id}/checkout-mailboxes",
+    "/provider-domains/{domain_id}/connect-provider",
+    "/provider-domains/{domain_id}/dns",
+    "/public/enrich/lookup",
+    "/radar/aeo/run",
+    "/radar/competitors",
+    "/radar/competitors/bulk",
+    "/radar/competitors/{competitor_id}/scan",
+    "/radar/gaps/analyze",
+    "/radar/initiatives/measure",
+    "/radar/opportunities/approve-all",
+    "/radar/opportunities/{gap_id}/approve",
+    "/radar/reports",
+    "/radar/scan-all",
+    "/repos/{repo_id}/scan",
+    "/research-reports/generate",
+    "/research-reports/generate-all",
+    "/research-reports/retry",
+    "/research-reports/workflow/resume",
+    "/revenue/stage-docs/{lifecycle_entry_id}/{entity}/backfill",
+    "/scrape/requests",
+    "/search/companies",
+    "/search/companies/save",
+    "/search/contacts",
+    "/search/contacts/save",
+    "/seo/audits",
+    "/seo/keywords/research",
+    "/sequencer/content/email/generate",
+    "/sequencer/content/instructions/improve",
+    "/sequencer/content/linkedin/generate",
+    "/sequencer/templates/steps/generate",
+    "/social-listeners",
+    "/social-listeners/auto-seed/all",
+    "/social-listeners/auto-seed/brand",
+    "/social-listeners/auto-seed/competitors",
+    "/social-listeners/auto-seed/engagement",
+    "/social-listeners/auto-seed/keywords",
+    "/social-listeners/bulk-from-list",
+    "/social-listeners/integrations/x",
+    "/social-listeners/integrations/x/test",
+    "/social-listeners/posts/{post_id}/engagements/add-to-list",
+    "/social-listeners/posts/{post_id}/mark",
+    "/social-listeners/posts/{post_id}/save-contact",
+    "/social-listeners/queries/generate",
+    "/social/posts/generate",
+    "/tam/generate",
+    "/tam/regenerate",
+    "/tasks/{task_id}/start",
+    "/team-members/me/enrich-linkedin",
+    "/team-members/{team_member_id}/enrich-linkedin",
+    "/team-members/{team_member_id}/generate-post",
+    "/teams/auto-compose/suggest",
+    "/voice/agents/{agent_id}/documents/upload",
+    "/voice/call-flow-examples/transcribe",
+    "/voice/call-scripts/generate",
+    "/voice/campaigns/call-scripts",
+    "/voice/campaigns/email-enhancements",
+    "/voice/campaigns/email-spintax",
+    "/voice/campaigns/emails",
+    "/voice/campaigns/linkedin-messages",
+    "/voice/campaigns/onboarding/messages",
+    "/voice/campaigns/onboarding/threads/actions",
+    "/voice/campaigns/voicemails",
+    "/voice/chat-agent/messages",
+    "/voice/collections/{collection_id}/files/paste-text",
+    "/voice/collections/{collection_id}/files/upload",
+    "/voice/collections/{collection_id}/files/upload-multiple",
+    "/voice/collections/{collection_id}/reindex",
+    "/voice/collections/{collection_id}/scrape-sources",
+    "/voice/collections/{collection_id}/scrape-sources/{source_id}/run",
+    "/voice/email-agent/batch",
+    "/voice/email-agent/compose",
+    "/voice/email-agent/draft-reply",
+    "/voice/icp/queries",
+    "/voice/knowledge-base/files/upload",
+    "/voice/receptionist/messages",
+    "/voice/research/company",
+    "/voice/research/org-chart",
+    "/voice/research/prospect-data",
+    "/voice/research/prospect-profile",
+    "/voice/topics/classify",
+    "/voice/twins",
+    "/voice/twins/extract-linkedin",
+    "/voice/video-recordings/upload",
+    "/voice/voice-library/onboarding-voice",
+    "/voice/voice-library/voices",
+    "/voice/worksheets/calculate",
+    "/work/signals/promote",
+    "/workbench/tables/{table_id}/ai/generate-prompt",
+    "/workbench/tables/{table_id}/ai/groups/{group_id}/run",
+    "/workbench/tables/{table_id}/ai/preview",
+    "/workbench/tables/{table_id}/ai/run",
+    "/workbench/tables/{table_id}/ai/run-all",
+    "/workbench/tables/{table_id}/columns/{col_id}/ai/run",
+    "/workbench/tables/{table_id}/find-people/configure",
+    "/workbench/tables/{table_id}/find-people/{config_id}/run",
+    "/workbench/tables/{table_id}/import/search",
+    "/workbench/tables/{table_id}/import/search/research/preview",
+    "/workbench/tables/{table_id}/pipelines",
+    "/workbench/tables/{table_id}/scraper/providers/{provider}/runs",
+    "/workbench/tables/{table_id}/scraper/runs",
+    "/workbench/tables/{table_id}/suggest-mappings",
+    "/workbench/tables/{table_id}/triggers",
+    "/workbench/tables/{table_id}/unlock-rows",
+    "/workbench/tables/{table_id}/waterfall/configs/{column_id}/run"
+  ],
+  PUT: [
+    "/agent/operators/{operator}/enabled",
+    "/agent/operators/{operator}/skills/{skill_key}",
+    "/deliverability/autopilot/preferences",
+    "/enrichment/auto-enrichment/settings/{entity_type}",
+    "/enrichment/lists/{list_id}/pipelines/{pipeline_id}",
+    "/enrichment/record-sync/{entity_type}/policy",
+    "/enrichment/waterfall/configs/{column_id}",
+    "/marketplace/me/invoices/{invoice_id}",
+    "/marketplace/me/rates",
+    "/radar/settings",
+    "/workbench/tables/{table_id}/auto-enrich",
+    "/workbench/tables/{table_id}/pipelines/{pipeline_id}",
+    "/workbench/tables/{table_id}/schedule",
+    "/workbench/tables/{table_id}/triggers/{trigger_id}"
+  ]
+};
+
+// src/generated/external.ts
+var EXTERNAL_ROUTES = {
+  GET: [
+    "/dialer/sessions/token",
+    "/marketplace/me/connect/dashboard-link",
+    "/marketplace/me/connect/onboarding-link",
+    "/marketplace/me/payout-account/login-link",
+    "/marketplace/me/payout-account/onboarding-link",
+    "/voice/mcp-servers/{mcp_server_id}/tools"
+  ],
+  PATCH: [
+    "/ad-campaigns/{campaign_id}/ads/{ad_id}",
+    "/appointments/bookings/{booking_uid}/location",
+    "/appointments/bookings/{booking_uid}/sequence",
+    "/appointments/workflows/{workflow_id}",
+    "/audience-syncs/{config_id}",
+    "/campaigns/{campaign_id}",
+    "/campaigns/{campaign_id}/full",
+    "/content/calendar/{content_type}/{content_id}/schedule",
+    "/inbox/mailboxes/bulk",
+    "/inbox/mailboxes/{mailbox}/settings",
+    "/integrations/crm/meetings/{event_id}",
+    "/newsletters/{newsletter_id}/subscribers/{subscriber_id}/unsubscribe",
+    "/quotes/{quote_id}",
+    "/sequences/{sequence_id}",
+    "/sequences/{sequence_id}/steps/{step_id}",
+    "/voice/dialer/sessions/{session_id}/status",
+    "/voice/dispositions/{disposition_id}",
+    "/webhooks/{webhook_id}"
+  ],
+  POST: [
+    "/ad-campaigns/images",
+    "/ad-campaigns/status-refresh",
+    "/ad-campaigns/{campaign_id}/ads",
+    "/ad-campaigns/{campaign_id}/ads/batch",
+    "/ad-campaigns/{campaign_id}/ads/{ad_id}/status",
+    "/ad-campaigns/{campaign_id}/edit-preview",
+    "/ad-campaigns/{campaign_id}/retry",
+    "/ad-campaigns/{campaign_id}/status-refresh",
+    "/appointments/bookings",
+    "/appointments/bookings/import",
+    "/appointments/bookings/{booking_uid}/confirm",
+    "/appointments/bookings/{booking_uid}/guests",
+    "/appointments/bookings/{booking_uid}/mark-absent",
+    "/appointments/bookings/{booking_uid}/notes",
+    "/appointments/bookings/{booking_uid}/request-reschedule",
+    "/appointments/bookings/{booking_uid}/reschedule",
+    "/appointments/calendars/selected",
+    "/appointments/conferencing/connect/{provider}",
+    "/appointments/conferencing/{provider}/default",
+    "/appointments/workflows",
+    "/appointments/workflows/{workflow_id}/toggle",
+    "/audience-syncs",
+    "/audience-syncs/google/conversion-actions",
+    "/audience-syncs/google/conversions",
+    "/audience-syncs/google/video-assets/library",
+    "/audience-syncs/google/video-assets/links",
+    "/audience-syncs/google/video-assets/upload-urls",
+    "/audience-syncs/google/video-assets/uploads",
+    "/audience-syncs/{config_id}/launch",
+    "/audience-syncs/{config_id}/trigger",
+    "/campaigns",
+    "/campaigns/{campaign_id}/ad-images/{image_id}/hide",
+    "/campaigns/{campaign_id}/documents",
+    "/campaigns/{campaign_id}/launch",
+    "/campaigns/{campaign_id}/sequence/steps",
+    "/content/calendar/{content_type}/{content_id}/retry-publish",
+    "/crm-syncs/{provider}/companies/push",
+    "/crm-syncs/{provider}/contacts/push",
+    "/crm-syncs/{provider}/lists/push",
+    "/customer-success/companies/{company_id}/sync",
+    "/desk/accounts/{account_id}/committee/plays/{action_id}/run",
+    "/desk/accounts/{account_id}/committee/{contact_id}/linkedin-invite",
+    "/desk/decisions/{decision_id}/plays/{action_id}/run",
+    "/desk/decisions/{decision_id}/send-reply",
+    "/desk/decisions/{decision_id}/send-sms",
+    "/desk/plays/approvals/{execution_id}/decide",
+    "/dialer/parallel-calls/calls/{livekit_room_name}/drop-voicemail",
+    "/dialer/parallel-calls/manual-dial",
+    "/dialer/parallel-calls/redial-contact",
+    "/dialer/parallel-calls/sessions/start",
+    "/dialer/sessions/calls/drop-voicemail",
+    "/dialer/sessions/{session_id}/next-batch",
+    "/envelopes/{envelope_id}/resend",
+    "/envelopes/{envelope_id}/send",
+    "/feedback/sending-domains/verify",
+    "/feedback/surveys/{survey_id}/send",
+    "/forms/deliveries/{receipt_id}/retry",
+    "/forms/{form_key}/backfills",
+    "/forms/{form_key}/delivery/pause",
+    "/forms/{form_key}/delivery/resume",
+    "/inbox/emails/compose",
+    "/inbox/emails/{email_id}/send",
+    "/inbox/linkedin/accounts/sync",
+    "/inbox/linkedin/accounts/{account_id}/enable",
+    "/inbox/linkedin/compose",
+    "/inbox/mailboxes/activate",
+    "/inbox/mailboxes/{mailbox}/sync",
+    "/inbox/sms/compose",
+    "/inbox/{reply_id}/assign",
+    "/inbox/{reply_id}/send",
+    "/inbox/{reply_id}/tag",
+    "/integrations/connections",
+    "/integrations/connections/session-token",
+    "/integrations/crm-sync/audiences",
+    "/integrations/crm-sync/contacts/pull",
+    "/integrations/crm-sync/contacts/push",
+    "/integrations/crm-sync/deals/pull",
+    "/integrations/crm-sync/deals/push",
+    "/integrations/crm-sync/leads/previews",
+    "/integrations/crm-sync/leads/pull",
+    "/integrations/crm-sync/leads/push",
+    "/integrations/crm-sync/pull",
+    "/integrations/crm-sync/push",
+    "/integrations/crm/connections/{connection_id}/batch/contacts",
+    "/integrations/crm/connections/{connection_id}/companies",
+    "/integrations/crm/connections/{connection_id}/contacts",
+    "/integrations/crm/connections/{connection_id}/deals",
+    "/integrations/crm/connections/{connection_id}/leads",
+    "/integrations/crm/lists",
+    "/integrations/crm/lists/memberships",
+    "/integrations/crm/meetings",
+    "/integrations/linkedin-outreach/campaigns/{campaign_id}/pause",
+    "/integrations/linkedin-outreach/campaigns/{campaign_id}/resume",
+    "/integrations/linkedin-outreach/connection/reconnect",
+    "/integrations/linkedin-outreach/lists",
+    "/integrations/linkedin-outreach/lists/{list_id}/leads",
+    "/integrations/linkedin-outreach/workspaces/sync",
+    "/integrations/migrations/delta-sync",
+    "/integrations/migrations/discovery",
+    "/integrations/migrations/{migration_id}/confirm",
+    "/integrations/sugarcrm/connect",
+    "/integrations/sugarcrm/reconnect",
+    "/landing-pages/{landing_page_id}/publish",
+    "/landing-pages/{landing_page_id}/unpublish",
+    "/linkedin/accounts/sync",
+    "/marketplace/agencies/{slug}/reps/{sdr_id}/publish",
+    "/marketplace/me/messages/{conversation_id}/reply",
+    "/marketplace/me/payout-account/bank-details",
+    "/marketplace/me/payout-account/methods",
+    "/marketplace/me/payout-account/setup",
+    "/marketplace/me/sync-workbench",
+    "/marketplace/talent/{sdr_id}/messages",
+    "/marketplace/talent/{sdr_id}/request",
+    "/newsletters",
+    "/newsletters/{newsletter_id}/activate",
+    "/newsletters/{newsletter_id}/issues",
+    "/newsletters/{newsletter_id}/issues/{issue_id}/duplicate",
+    "/newsletters/{newsletter_id}/issues/{issue_id}/send",
+    "/newsletters/{newsletter_id}/issues/{issue_id}/send-test",
+    "/newsletters/{newsletter_id}/issues/{issue_id}/send/resume",
+    "/newsletters/{newsletter_id}/resume",
+    "/newsletters/{newsletter_id}/settings/verify-domain",
+    "/newsletters/{newsletter_id}/subscribers",
+    "/nurtures/{nurture_id}/launch",
+    "/org/sso/sync",
+    "/phone-numbers/a2p/register",
+    "/profile/deal-automations/sync-now",
+    "/programmatic-campaigns/{campaign_id}/pages/actions",
+    "/programmatic-campaigns/{campaign_id}/pages/{page_id}/actions",
+    "/provider-domains/{domain_id}/forwarding",
+    "/provider-domains/{domain_id}/mailbox-profile-picture",
+    "/provider-domains/{domain_id}/regenerate-nameservers",
+    "/provider-domains/{domain_id}/resend-transfer-password",
+    "/provider-domains/{domain_id}/resend-verification",
+    "/provider-domains/{domain_id}/set-nameservers",
+    "/provider-usage/refresh",
+    "/provider-usage/sync",
+    "/quote-billing-contact",
+    "/quote-contacts",
+    "/quote-settings/documents",
+    "/quote-templates",
+    "/quotes",
+    "/quotes/batch",
+    "/quotes/{quote_id}/duplicate",
+    "/quotes/{quote_id}/edit-as-draft",
+    "/quotes/{quote_id}/mark-accepted",
+    "/quotes/{quote_id}/send",
+    "/quotes/{quote_id}/unarchive",
+    "/radar/alerts/dispatch",
+    "/repos/{repo_id}/campaigns/{campaign_id}/launch",
+    "/sales-coach/interviews/{interview_id}/members",
+    "/sales-coach/interviews/{interview_id}/members/{member_id}/send-invite",
+    "/sequencer/content/voice/test-call",
+    "/sequences",
+    "/sequences/generate-spintax",
+    "/sequences/{sequence_id}/contacts",
+    "/sequences/{sequence_id}/contacts/{contact_id}/resume",
+    "/sequences/{sequence_id}/pause",
+    "/sequences/{sequence_id}/resume",
+    "/sequences/{sequence_id}/run",
+    "/sequences/{sequence_id}/sync",
+    "/settings/scrape-config/crawl",
+    "/skills/{action_id}/execute",
+    "/skills/{action_id}/test-runs",
+    "/social-listeners/posts/{post_id}/add-to-sequence",
+    "/social/posts/{post_id}/engagers/add-to-audience",
+    "/social/posts/{post_id}/engagers/enroll",
+    "/social/posts/{post_id}/publish",
+    "/social/posts/{post_id}/schedule",
+    "/stripe/api-key",
+    "/stripe/sync",
+    "/team-members/sync",
+    "/voice/calls",
+    "/voice/dialer/sessions",
+    "/voice/dialer/sessions/{session_id}/resume",
+    "/voice/dispositions",
+    "/voice/inbound-calls/decline",
+    "/voice/inbound-calls/dialer/{call_id}/decline",
+    "/voice/inbound-calls/{room_name}/claim",
+    "/voice/mcp-servers/{mcp_server_id}/test",
+    "/webhooks",
+    "/webhooks/{webhook_id}/rotate-secret",
+    "/website-editor/publish",
+    "/website-editor/sync",
+    "/workbench/scraper/providers/{provider}/connection/test",
+    "/workbench/tables/{table_id}/import/crm",
+    "/workbench/tables/{table_id}/send-to-sequence",
+    "/workflows",
+    "/workflows/executions/approve",
+    "/workflows/executions/bulk-restart",
+    "/workflows/executions/request-changes",
+    "/workflows/executions/{execution_id}/pause",
+    "/workflows/executions/{execution_id}/restart",
+    "/workflows/executions/{execution_id}/resume",
+    "/workflows/executions/{execution_id}/stop",
+    "/workflows/integrations/{provider_name}/test",
+    "/workflows/validate",
+    "/workflows/workbenches",
+    "/workflows/{action_id}/execute",
+    "/workflows/{action_id}/trigger-reset"
+  ],
+  PUT: [
+    "/ad-campaigns/{campaign_id}",
+    "/appointments/calendars/destination",
+    "/appointments/conferencing/{provider}/link",
+    "/campaigns/{campaign_id}/audience",
+    "/campaigns/{campaign_id}/documents/{document_id}",
+    "/campaigns/{campaign_id}/sequence",
+    "/campaigns/{campaign_id}/sequence/steps/{step_id}",
+    "/desk/autonomy",
+    "/desk/org-settings",
+    "/inbox/linkedin/accounts/{account_id}",
+    "/integrations/crm-sync/pull-enabled",
+    "/integrations/crm-sync/push-enabled",
+    "/integrations/crm/connections/{connection_id}/batch/contacts",
+    "/integrations/crm/connections/{connection_id}/companies/{company_id}",
+    "/integrations/crm/connections/{connection_id}/contacts/{contact_id}",
+    "/integrations/crm/connections/{connection_id}/deals/{deal_id}",
+    "/integrations/crm/connections/{connection_id}/leads/{lead_id}",
+    "/integrations/linkedin-outreach/workspaces/active",
+    "/linkedin/accounts/{account_id}/schedule",
+    "/newsletters/{newsletter_id}/issues/{issue_id}",
+    "/quote-settings",
+    "/quote-templates/{template_id}",
+    "/quotes/{quote_id}",
+    "/sms/phone-numbers/{phone_number}",
+    "/social/autopilot/{account_id}",
+    "/workflows/{action_id}"
+  ]
+};
+
 // src/http.ts
 var G8Error = class _G8Error extends Error {
   constructor(args) {
@@ -349,9 +1005,70 @@ var G8Error = class _G8Error extends Error {
 function isRetryableStatus(status) {
   return status === 429 || status >= 500 && status <= 599;
 }
-function isNonIdempotentMethod(method) {
+function isWriteMethod(method) {
   const m = method.toUpperCase();
-  return m === "POST" || m === "PATCH";
+  return m === "POST" || m === "PUT" || m === "PATCH" || m === "DELETE";
+}
+var API_BASE_SEGMENT = "/api/v1";
+var billableMatchers = null;
+var externalMatchers = null;
+function templateToRegexSource(template) {
+  return template.split(/(\{[^}/]+\})/).map((part) => /^\{[^}/]+\}$/.test(part) ? "[^/]+" : part.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("");
+}
+function buildMatchers(routes) {
+  const out = /* @__PURE__ */ new Map();
+  for (const [m, templates] of Object.entries(routes)) {
+    if (!templates.length) continue;
+    out.set(m, new RegExp(`^(?:${templates.map(templateToRegexSource).join("|")})/?$`));
+  }
+  return out;
+}
+function matcherFor(method) {
+  if (!billableMatchers) billableMatchers = buildMatchers(BILLABLE_ROUTES);
+  return billableMatchers.get(method.toUpperCase());
+}
+function externalMatcherFor(method) {
+  if (!externalMatchers) externalMatchers = buildMatchers(EXTERNAL_ROUTES);
+  return externalMatchers.get(method.toUpperCase());
+}
+function apiRelativePath(urlOrPath) {
+  let p = urlOrPath.replace(/^[a-zA-Z][a-zA-Z0-9+.-]*:\/\/[^/]*/, "");
+  p = p.split(/[?#]/, 1)[0];
+  const at = p.indexOf(API_BASE_SEGMENT + "/");
+  if (at < 0) return null;
+  return p.slice(at + API_BASE_SEGMENT.length);
+}
+function isBillableOperation(method, urlOrPath) {
+  const matcher = matcherFor(method);
+  if (!matcher) return false;
+  const p = apiRelativePath(urlOrPath);
+  return p != null && matcher.test(p);
+}
+function isExternalOperation(method, urlOrPath) {
+  const matcher = externalMatcherFor(method);
+  if (!matcher) return false;
+  const p = apiRelativePath(urlOrPath);
+  return p != null && matcher.test(p);
+}
+function isNoBlindRetryOperation(method, urlOrPath) {
+  return isBillableOperation(method, urlOrPath) || isExternalOperation(method, urlOrPath);
+}
+var PRE_SEND_ERROR_CODES = /* @__PURE__ */ new Set([
+  "ECONNREFUSED",
+  "ENOTFOUND",
+  "EAI_AGAIN",
+  "ENETUNREACH",
+  "EHOSTUNREACH",
+  "UND_ERR_CONNECT_TIMEOUT"
+]);
+function isPreSendNetworkError(err) {
+  let cur = err;
+  for (let depth = 0; cur && depth < 4; depth++) {
+    if (typeof cur.code === "string" && PRE_SEND_ERROR_CODES.has(cur.code)) return true;
+    if (Array.isArray(cur.errors) && cur.errors.some((e) => isPreSendNetworkError(e))) return true;
+    cur = cur.cause;
+  }
+  return false;
 }
 function newIdempotencyKey() {
   const c = globalThis.crypto;
@@ -389,7 +1106,7 @@ function buildQuery(query) {
   const s = qs.toString();
   return s ? `?${s}` : "";
 }
-async function toG8Error(resp) {
+async function toG8Error(resp, retryable = isRetryableStatus(resp.status)) {
   let body = void 0;
   try {
     const text = await resp.text();
@@ -406,9 +1123,36 @@ async function toG8Error(resp) {
     code: typeof env.code === "string" ? env.code : String(resp.status),
     requestId: typeof env.request_id === "string" && env.request_id || resp.headers.get("x-request-id") || void 0,
     detail: env.detail,
-    retryable: isRetryableStatus(resp.status)
+    retryable
   });
 }
+var TARGET_ORG_HEADER = "x-target-org-id";
+var nonAgencyKeys = /* @__PURE__ */ new Set();
+var warnedTargetOrgKeys = /* @__PURE__ */ new Set();
+function keyFingerprint(apiKey) {
+  let h = 2166136261;
+  for (let i = 0; i < apiKey.length; i++) {
+    h ^= apiKey.charCodeAt(i);
+    h = Math.imul(h, 16777619) >>> 0;
+  }
+  return `${apiKey.length}:${h.toString(36)}`;
+}
+function noteAgencyStatus(apiKey, isAgency) {
+  const fp = keyFingerprint(apiKey);
+  if (isAgency) nonAgencyKeys.delete(fp);
+  else nonAgencyKeys.add(fp);
+}
+function warnIfTargetOrgIgnored(apiKey, headers) {
+  if (!Object.keys(headers).some((h) => h.toLowerCase() === TARGET_ORG_HEADER)) return;
+  const fp = keyFingerprint(apiKey);
+  if (!nonAgencyKeys.has(fp) || warnedTargetOrgKeys.has(fp)) return;
+  warnedTargetOrgKeys.add(fp);
+  if (typeof console !== "undefined" && typeof console.warn === "function") {
+    console.warn(
+      "[@graph8/sdk] X-Target-Org-Id is set, but the server reported this API key is not an agency key. The header is ignored for non-agency keys: this call runs against the key's own org. Use an agency key (minted with is_agency=true) to target a client org."
+    );
+  }
+}
 async function request(baseUrl, path, apiKey, opts = {}) {
   const {
     method = "GET",
@@ -428,8 +1172,10 @@ async function request(baseUrl, path, apiKey, opts = {}) {
     Authorization: `Bearer ${apiKey}`,
     ...headers
   };
-  const effectiveIdempotencyKey = idempotencyKey ?? (maxRetries > 0 && isNonIdempotentMethod(method) ? newIdempotencyKey() : void 0);
+  warnIfTargetOrgIgnored(apiKey, headers);
+  const effectiveIdempotencyKey = idempotencyKey ?? (maxRetries > 0 && isWriteMethod(method) ? newIdempotencyKey() : void 0);
   if (effectiveIdempotencyKey) finalHeaders["Idempotency-Key"] = effectiveIdempotencyKey;
+  const billable = isNoBlindRetryOperation(method, url);
   let attempt = 0;
   for (; ; ) {
     let resp;
@@ -441,7 +1187,8 @@ async function request(baseUrl, path, apiKey, opts = {}) {
         signal
       });
     } catch (err) {
-      if (attempt < maxRetries) {
+      const safeToRetry = !billable || isPreSendNetworkError(err);
+      if (attempt < maxRetries && safeToRetry) {
         await sleepImpl(backoffDelayMs(attempt, retryBaseMs));
         attempt++;
         continue;
@@ -450,21 +1197,22 @@ async function request(baseUrl, path, apiKey, opts = {}) {
         message: `Network error: ${err?.message ?? "request failed"}`,
         status: 0,
         type: "network_error",
-        retryable: true
+        retryable: safeToRetry
       });
     }
     if (resp.ok) {
       const text = await resp.text();
       return text ? JSON.parse(text) : void 0;
     }
-    if (isRetryableStatus(resp.status) && attempt < maxRetries) {
+    const statusRetryable = isRetryableStatus(resp.status) && (!billable || resp.status === 429);
+    if (statusRetryable && attempt < maxRetries) {
       const retryAfter = parseRetryAfter(resp.headers.get("retry-after"));
       const delay = retryAfter != null ? retryAfter : backoffDelayMs(attempt, retryBaseMs);
       await sleepImpl(delay);
       attempt++;
       continue;
     }
-    throw await toG8Error(resp);
+    throw await toG8Error(resp, billable ? statusRetryable : isRetryableStatus(resp.status));
   }
 }
 async function* paginate(fetchPage) {
@@ -693,30 +1441,74 @@ var createCampaignsClient = (apiKey, apiUrl) => {
 
 // src/signals.ts
 var DEFAULT_API9 = "https://be.graph8.com";
+var INTENT_READ_HINT = "g8.signals needs an API key with the intent:read scope. Personal keys and keys minted before scoped keys do not carry it. Mint a key with intent:read (Settings > API keys), or pass a writeKey to g8.init() to read signals with the browser write key.";
+function explainSignalsError(err) {
+  if (err instanceof G8Error && err.status === 403) {
+    throw new G8Error({
+      message: `${INTENT_READ_HINT} (server said: ${err.message})`,
+      status: err.status,
+      type: err.type,
+      code: err.code,
+      requestId: err.requestId,
+      detail: err.detail,
+      retryable: false
+    });
+  }
+  throw err;
+}
 var createSignalsClient = (key, isApiKey, apiUrl) => {
   const baseUrl = apiUrl || DEFAULT_API9;
   const headers = () => isApiKey ? { "Content-Type": "application/json", "Authorization": `Bearer ${key}` } : { "Content-Type": "application/json", "X-Write-Key": key };
   const endpoint = "/api/v1/public/signals/company";
   return {
-    /** Get intent signals for a specific company domain. */
+    /**
+     * Get intent signals for a specific company domain.
+     *
+     * With an API key this throws a `G8Error` on any failure; a 403 means the
+     * key lacks the `intent:read` scope. With a write key only, a failure still
+     * resolves to an all-zeros result (legacy browser behaviour).
+     */
     async company(domain) {
+      if (isApiKey) {
+        const body = await request(baseUrl, endpoint, key, {
+          query: { domain }
+        }).catch(explainSignalsError);
+        return body?.data || body;
+      }
       const resp = await fetch(`${baseUrl}${endpoint}?domain=${encodeURIComponent(domain)}`, { headers: headers() });
       if (!resp.ok) return { domain, score: 0, intent: "low", signals: [], last_seen: null };
       const data = await resp.json();
       return data.data || data;
     },
-    /** Stream intent signals - calls callback every 30s with latest data. */
+    /**
+     * Stream intent signals - calls callback every 30s with latest data.
+     *
+     * A failed poll is skipped. An auth failure (401/403) cannot fix itself by
+     * waiting, so it stops the stream and is logged once instead of polling a
+     * forbidden route every 30s forever.
+     */
     stream(domains, callback) {
+      let interval;
+      let stopped = false;
+      const stop = () => {
+        stopped = true;
+        if (interval !== void 0) clearInterval(interval);
+      };
       const check = async () => {
         try {
           const results = await Promise.all(domains.map((d) => this.company(d)));
-          callback(results);
-        } catch {
+          if (!stopped) callback(results);
+        } catch (err) {
+          if (err instanceof G8Error && (err.status === 401 || err.status === 403)) {
+            stop();
+            if (typeof console !== "undefined") console.warn(`[@graph8/sdk] signals.stream stopped: ${err.message}`);
+          }
         }
       };
       check();
-      const interval = setInterval(check, 3e4);
-      return () => clearInterval(interval);
+      interval = setInterval(check, 3e4);
+      if (stopped) clearInterval(interval);
+      return stop;
     }
   };
 };
@@ -758,8 +1550,14 @@ var createVoiceClient = (apiKey, apiUrl) => {
       return resp.data ?? resp;
     },
     /**
-     * Resume a PAUSED dialer session. Auto-fetches the next batch from the source list,
-     * filters already-called + phoneless rows, and forwards to voice's start-session.
+     * Resume a PAUSED dialer session.
+     *
+     * @deprecated The server route is retired and answers 410 (it never dialed:
+     * it forwarded to a voice path that did not exist, and the LiveKit dialer it
+     * targeted has been removed). Resume with
+     * `g8.api.call("dial_next_batch_dialer_sessions__session_id__next_batch_post",
+     * { path: { session_id }, body: { resume_intent: true } })`; the rep must have
+     * the dialer open to take the calls.
      * @param maxContacts 1-4 (voice caps parallel dialing at 4). Default 4.
      */
     async resumeSession(sessionId, maxContacts = 4) {
@@ -913,7 +1711,61 @@ var KNOWN_WEBHOOK_EVENTS = [
   "crm.record.created",
   "crm.record.updated",
   "crm.record.archived",
-  "crm.record.restored"
+  "crm.record.restored",
+  "sequence.contact_enrolled",
+  "sequence.contact_removed",
+  "sequence.step_completed",
+  "sequence.step_failed",
+  "engagement.contact_unsubscribed",
+  "engagement.sms_delivered",
+  "engagement.sms_failed",
+  "engagement.whatsapp_delivered",
+  "engagement.whatsapp_failed",
+  "engagement.call_started",
+  "engagement.call_completed",
+  "engagement.call_disposition_set",
+  "engagement.voicemail_detected",
+  "engagement.voicemail_left",
+  "engagement.email_clicked",
+  "engagement.link_clicked",
+  "engagement.call_recording_ready",
+  "meeting.no_show",
+  "voice_ai.call_started",
+  "voice_ai.call_completed",
+  "voice_ai.voicemail_left",
+  "deal.created",
+  "deal.updated",
+  "deal.stage_changed",
+  "deal.deleted",
+  "quote.created",
+  "quote.updated",
+  "quote.sent",
+  "quote.resent",
+  "quote.resend_failed",
+  "quote.link_generated",
+  "quote.viewed",
+  "quote.accepted",
+  "quote.declined",
+  "quote.expired",
+  "quote.voided",
+  "quote.superseded",
+  "quote.archived",
+  "quote.unarchived",
+  "quote.payment_received",
+  "quote.payment_failed",
+  "quote.subscription_canceled",
+  "quote.provisioned",
+  "form.submitted",
+  "visitor.identified",
+  "intent.signal",
+  "task.created",
+  "task.updated",
+  "task.completed",
+  "task.deleted",
+  "enrichment.job_completed",
+  "enrichment.job_failed",
+  "workflow.execution_completed",
+  "workflow.execution_failed"
 ];
 var WebhookSignatureError = class extends Error {
   constructor(message) {
@@ -1253,7 +2105,7 @@ var createMailboxesClient = (apiKey, apiUrl) => {
 };
 
 // src/generated/operations.ts
-var API_OPERATION_COUNT = 3246;
+var API_OPERATION_COUNT = 3247;
 var API_OPERATIONS = {
   accept_audience_pipeline_filters_campaigns__campaign_id__audience_pipeline_accept_filters_post: ["POST", "/campaigns/{campaign_id}/audience-pipeline/accept-filters", "campaigns", "acceptAudiencePipelineFilters", "billable", "campaigns:run"],
   accept_my_offer_marketplace_me_offers__hiring_id__accept_post: ["POST", "/marketplace/me/offers/{hiring_id}/accept", "marketplace", "acceptMyOffer", "billable", "marketplace:run"],
@@ -3249,6 +4101,7 @@ var API_OPERATIONS = {
   list_onboarding_threads_voice_campaigns_onboarding_threads_get: ["GET", "/voice/campaigns/onboarding/threads", "voice", "listOnboardingThreads", "read", "voice:read"],
   list_ooo_appointments_out_of_office_get: ["GET", "/appointments/out-of-office", "appointments", "listOoo", "read", "meetings:read"],
   list_opportunities_radar_opportunities_get: ["GET", "/radar/opportunities", "radar", "listOpportunities", "read", "radar:read"],
+  list_org_events_events_get: ["GET", "/events", "events", "listOrgEvents", "read", "analytics:read"],
   list_org_marketplace_hirings_marketplace_org_hirings_get: ["GET", "/marketplace/org/hirings", "marketplace", "listOrgMarketplaceHirings", "read", "marketplace:read"],
   list_org_marketplace_invoices_marketplace_org_invoices_get: ["GET", "/marketplace/org/invoices", "marketplace", "listOrgMarketplaceInvoices", "read", "marketplace:read"],
   list_org_marketplace_meetings_marketplace_org_meetings_get: ["GET", "/marketplace/org/meetings", "marketplace", "listOrgMarketplaceMeetings", "read", "marketplace:read"],
@@ -6067,17 +6920,35 @@ var createSearchClient = (apiKey, apiUrl) => {
 
 // src/agency.ts
 var DEFAULT_API35 = "https://be.graph8.com";
+function mentionsAgencyRequirement(err) {
+  const text = `${err.message} ${typeof err.detail === "string" ? err.detail : JSON.stringify(err.detail ?? "")}`;
+  return /agency-scoped/i.test(text);
+}
 var createAgencyClient = (apiKey, apiUrl) => {
   const baseUrl = apiUrl || DEFAULT_API35;
+  const recordingAgencyStatus = async (call) => {
+    try {
+      return await call();
+    } catch (err) {
+      if (err instanceof G8Error && err.status === 403 && mentionsAgencyRequirement(err)) {
+        noteAgencyStatus(apiKey, false);
+      }
+      throw err;
+    }
+  };
   return {
     /** Describe the agency credential: agency org + authorized client count. */
     async me() {
-      const resp = await request(baseUrl, "/api/v1/agency/me", apiKey);
-      return resp.data ?? resp;
+      const resp = await recordingAgencyStatus(
+        () => request(baseUrl, "/api/v1/agency/me", apiKey)
+      );
+      const info = resp.data ?? resp;
+      if (typeof info?.is_agency === "boolean") noteAgencyStatus(apiKey, info.is_agency);
+      return info;
     },
     /** List the client orgs this agency key may target via `X-Target-Org-Id`. */
     async clients() {
-      return request(baseUrl, "/api/v1/agency/clients", apiKey);
+      return recordingAgencyStatus(() => request(baseUrl, "/api/v1/agency/clients", apiKey));
     }
   };
 };