Enrichment

Bind reviewed Audience members to a closed enrichment field plan without calling a provider.

Enrichment Specifications are Preview, contract-only plans over exact members of an immutable Audience snapshot. They are the single planning surface for contact and company completion, including business-email discovery through work_email fields. No current public operation executes enrichment.

Preview operation create_enrichment_specification_v1_enrichment_specifications_post requires a caller key, audience_id, expected Audience result hash, bounded member selection, requested field contracts, expected policy version, and reason. It fails closed if the snapshot, member IDs, hash, environment, or policy version do not match.

curl --fail-with-body --silent --show-error \
  --request POST "$BLACKPEARL_API_BASE_URL/v1/enrichment-specifications" \
  --header "Authorization: Bearer $BLACKPEARL_API_KEY" \
  --header "Content-Type: application/json" \
  --data @enrichment-specification.json

Preview operation list_enrichment_specifications_v1_enrichment_specifications_get lists project/environment specifications with cursor pagination. Preview operation get_enrichment_specification_v1_enrichment_specifications__specification_id__get retrieves one immutable record.

Every record reports provider execution unavailable and zero processed or enriched rows. Creating a plan does not discover an email, verify deliverability, grant consent, export data, update a CRM, or authorize outbound contact.