v4

latestOpenAPI 3.1.02026-08-03427198448.4 KB
prospecting

Get Network Summary

Return the prospecting agent's contact pool composition.

The "remaining_potential_count" (the AI Zone's "Available Contacts") is GOAL-SCOPED: exclusions only count for the goal a run will actually use.

  • goal_id: scope exclusions to that goal at its current version (the pool reflects what that goal has already triaged).
  • fresh=true: preview for a brand-NEW goal — it has excluded no one yet, so the full eligible pool is available (the "new goal resets the pool" case). Implemented via a sentinel goal_id that matches no existing deal.
  • neither: legacy goal-blind composition (back-compat for other callers).

bypass_cache=true is orthogonal to the above: it skips the cached value for whichever scope was resolved, recomputes, and repopulates the cache with the fresh result (so other readers of that scope also benefit). Used right after a client-side contact import — those writes go straight to Supabase and never invalidate this process's cache, so without this the dialog can show stale pre-import numbers for up to 5 minutes.

get/api/prospecting/network-summary

Query parameters

goal_idstring nullable
freshboolean
bypass_cacheboolean
user_idstring nullable
org_idstring nullable

Response

Successful Response

{"stackTrail":"paths:/api/prospecting/network-summary:get:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}