Browse docslist_goal_search_networks
list_goal_search_networks
Reads a page of eligible or unfinished network identities for an owned goal's current search.
Annotations: readOnlyHint: true · destructiveHint: false · idempotentHint: true · openWorldHint: false
Inputs#
| Input | Required | Type | Description |
|---|---|---|---|
goalId | yes | string | Exact goal UUID from an authorized list or retained reference |
state | no | string | eligible (default, new or updated networks) or failed (unfinished networks) |
pageSize | no | integer | Default 20, also for 0; capped at 100; negative or fractional values are invalid |
pageToken | no | string | Returned continuation; omit or use an empty string for the first page |
Returns#
networks and nextPageToken. Each network contains stable memberId, displayName, isCurrentMember, and reason (new, updated, or failed). These are coarse group-member identities, never contacts, private relationship evidence, or claims of willingness.
Order is the current member first, then name and stable member identity. Only an empty token means completion. Continue through empty pages, keeping the goal and state unchanged. Tokens are private, actor/query-bound, and expire after one hour. These are live reads; if the previous position disappears, restart the list. An owned goal with no current search returns an empty complete list. Inaccessible or other members' goals return unavailable.
Reading changes nothing. Use get_goal_search for counts and progress.
Example#
{
"goalId": "00000000-0000-4000-a000-000000000001"
}
Result (synthetic data):
{
"networks": [
{
"memberId": "00000000-0000-4000-a000-000000000003",
"displayName": "Synthetic member",
"isCurrentMember": true,
"reason": "updated"
}
],
"nextPageToken": ""
}