Account Coordination

Derive an immutable account-level preflight from a reviewed Audience and its Outcome evidence.

Account Coordination is a Preview, deterministic assessment over existing Blackpearl data. It detects risks such as contacting too many people at one account, stale evidence, restrictive feedback, and retry timing. It does not generate copy, assign a sender, create a task, mutate a CRM, or authorize contact.

Preview operation create_account_coordination_assessment_v1_account_coordination_assessments_post binds a caller key, audience_id, exact Audience result hash, company domain, expected policy version, and audit reason. The Audience must belong to the current project and API-key environment. Its immutable member snapshot and relevant append-only Outcomes are evaluated atomically.

curl --fail-with-body --silent --show-error \
  --request POST "$BLACKPEARL_API_BASE_URL/v1/account-coordination-assessments" \
  --header "Authorization: Bearer $BLACKPEARL_API_KEY" \
  --header "Content-Type: application/json" \
  --data "{
    \"key\": \"acme-preflight-20260717\",
    \"audience_id\": \"$AUDIENCE_ID\",
    \"expected_audience_result_hash\": \"$AUDIENCE_RESULT_HASH\",
    \"company_domain\": \"acme.example\",
    \"expected_policy_version\": \"2026-07-15\",
    \"reason\": \"Preflight before external campaign review\"
  }"

An exact key/request replay returns the existing assessment; a changed request under the same key conflicts. The result preserves evidence references, derived flags, decision, and any retry_after bound to the assessment policy version.

Preview operation get_account_coordination_assessment_v1_account_coordination_assessments__assessment_id__get reads one immutable assessment. Treat the decision as a preflight signal for a separately governed delivery system, never as consent or send authority.