Policy

Change a case's status or owner

Sets a case's status (open, investigating, contacted, resolved, dismissed) and/or owner (a member's user id, or null to unassign). Each actual change is added to the timeline; repeating the same values changes nothing. A resolved case reopens by itself when a new matching ad is observed later; a dismissed case stays dismissed. This records your team's follow-up only: it contacts no one. Requires the write scope.

post/projects/{project_id}/policy-cases/{case_id}

Request

  • Base URL: https://adslighthouse.com/api/v1
  • URL: https://adslighthouse.com/api/v1/projects/{project_id}/policy-cases/{case_id}
  • Auth: HTTP bearer

Path parameters

project_idstring required

The project: its id, its brand domain (for example nike.example) or its exact project or brand name. Unknown or ambiguous references return not_found; call list_projects then.

case_idstring required

The case id from list_policy_cases.

Request body

status'open' | 'investigating' | 'contacted' | 'resolved' | 'dismissed'
owner_user_idstring nullable

Response

Change a case's status or owner

idstring required
rule_idstring nullable required

null when the rule was deleted; rule_name is kept.

rule_namestring required
rule_type'forbidden_terms' | 'brand_term' | 'direct_linking' | 'promo_code' | 'position_limit' | 'affiliate_id' required
advertiser_domainstring required
affiliate_idstring nullable required
status'open' | 'investigating' | 'contacted' | 'resolved' | 'dismissed' required
owner_user_idstring nullable required
owner_emailstring nullable required
first_seen_atstring required
last_seen_atstring required
match_countinteger required

Every finding recorded on the case.

reopen_countinteger required

Times a new match reopened it after it was resolved.

request_idstring

Changes

No recorded changes to this operation across all 1 revision of this API.