Case actions

Record that a complaint was filed on a platform's form

Records on a case that a person filed a complaint on the platform's own form: platform, date filed (YYYY-MM-DD, not in the future), the platform's reference number and an optional note. It is added to the case timeline. Nothing is filed or sent by this tool: Google Ads and Microsoft Advertising have no API for trademark complaints, so the person submits on the platform's own form, and messages are sent from the person's own email. Requires the write scope and an idempotency key; a retry with the same key returns the same complaint.

post/projects/{project_id}/case-complaints

Request

  • Base URL: https://adslighthouse.com/api/v1
  • URL: https://adslighthouse.com/api/v1/projects/{project_id}/case-complaints
  • 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.

Headers

Idempotency-Keystring required

A unique value you choose for this request, such as a UUID. Repeating the same key returns the first result instead of starting paid work again.

Request body

case_type'policy' | 'affiliate' required

policy for a case from list_policy_cases; affiliate for a non-compliant affiliate case from list_affiliate_findings.

case_idstring

The policy case id. Required when case_type is policy.

affiliate_idstring

The affiliate ID exactly as list_affiliate_findings returns it. Required when case_type is affiliate.

platform'google_ads' | 'microsoft_advertising' required
filed_onstring required

YYYY-MM-DD in your time zone.

referencestring
notestring

Response

Record that a complaint was filed on a platform's form

createdboolean required
request_idstring

Changes

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