Keep the same operation and operation_id when retrying identical work. Reconcile an uncertain result before new work; never replay an old V1 write under a new V2 ID.
Check status, execution_state, error_code, output and evidence/resource references. Queued work is not complete: poll jobs.status.get.v2 in domain.workspace.v2. For read-back verification require read_back_verified=true where returned; reconcile failures without creating another object.
Output schema inside the result envelope
{
"$defs": {
"ContactNetworkPathsV2": {
"additionalProperties": false,
"properties": {
"contact_id": {
"format": "uuid",
"title": "Contact Id",
"type": "string"
},
"relationship_state": {
"enum": [
"connected",
"no_matching_contact",
"syncing",
"not_shared",
"unknown"
],
"title": "Relationship State",
"type": "string"
},
"network_scope": {
"enum": [
"self",
"workspace_consented"
],
"title": "Network Scope",
"type": "string"
},
"paths": {
"default": [],
"items": {
"$ref": "#/$defs/NetworkPathEvidenceV2"
},
"maxItems": 50,
"title": "Paths",
"type": "array"
},
"reason_code": {
"maxLength": 64,
"minLength": 1,
"title": "Reason Code",
"type": "string"
}
},
"required": [
"contact_id",
"relationship_state",
"network_scope",
"reason_code"
],
"title": "ContactNetworkPathsV2",
"type": "object"
},
"NetworkCoverageV2": {
"additionalProperties": false,
"properties": {
"network_scope": {
"enum": [
"self",
"workspace_consented"
],
"title": "Network Scope",
"type": "string"
},
"sync_state": {
"enum": [
"synced",
"syncing",
"degraded",
"not_connected",
"unknown"
],
"title": "Sync State",
"type": "string"
},
"requested_contacts": {
"maximum": 200,
"minimum": 0,
"title": "Requested Contacts",
"type": "integer"
},
"matched_contacts": {
"maximum": 200,
"minimum": 0,
"title": "Matched Contacts",
"type": "integer"
},
"visible_paths": {
"minimum": 0,
"title": "Visible Paths",
"type": "integer"
},
"last_synced_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Last Synced At"
},
"limitations": {
"default": [],
"items": {
"type": "string"
},
"maxItems": 10,
"title": "Limitations",
"type": "array"
}
},
"required": [
"network_scope",
"sync_state",
"requested_contacts",
"matched_contacts",
"visible_paths"
],
"title": "NetworkCoverageV2",
"type": "object"
},
"NetworkPathEvidenceV2": {
"additionalProperties": false,
"properties": {
"relationship_id": {
"format": "uuid",
"title": "Relationship Id",
"type": "string"
},
"contact_id": {
"format": "uuid",
"title": "Contact Id",
"type": "string"
},
"relationship_state": {
"enum": [
"connected",
"no_matching_contact",
"syncing",
"not_shared",
"unknown"
],
"title": "Relationship State",
"type": "string"
},
"path_type": {
"enum": [
"first_degree",
"second_degree",
"introduction",
"none"
],
"title": "Path Type",
"type": "string"
},
"network_scope": {
"enum": [
"self",
"workspace_consented"
],
"title": "Network Scope",
"type": "string"
},
"match_method": {
"enum": [
"provider_member_id_exact",
"linkedin_url_exact",
"approved_identity_match",
"unknown"
],
"title": "Match Method",
"type": "string"
},
"degree": {
"anyOf": [
{
"maximum": 3,
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Degree"
},
"member_user_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Member User Id"
},
"member_name": {
"anyOf": [
{
"maxLength": 255,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Member Name"
},
"is_self": {
"default": false,
"title": "Is Self",
"type": "boolean"
},
"freshness_at": {
"format": "date-time",
"title": "Freshness At",
"type": "string"
},
"selected_sender_reachable": {
"title": "Selected Sender Reachable",
"type": "boolean"
},
"evidence_refs": {
"default": [],
"items": {
"type": "string"
},
"maxItems": 10,
"title": "Evidence Refs",
"type": "array"
}
},
"required": [
"relationship_id",
"contact_id",
"relationship_state",
"path_type",
"network_scope",
"match_method",
"freshness_at",
"selected_sender_reachable"
],
"title": "NetworkPathEvidenceV2",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"relationships": {
"default": [],
"items": {
"$ref": "#/$defs/ContactNetworkPathsV2"
},
"maxItems": 200,
"title": "Relationships",
"type": "array"
},
"coverage": {
"$ref": "#/$defs/NetworkCoverageV2"
}
},
"required": [
"coverage"
],
"title": "NetworkPathsGetResultV2",
"type": "object"
}