COPS
Brand API

Set account status

PATCH
/accounts/status

Set the lifecycle status for accounts in your organization: 'active' (syncing and counted in analytics), 'watching' (syncing but not counted — competitor/benchmark accounts), or 'archived' (not syncing, history still counted — departed creators). Never touches per-video exclusions.

Authorization

apiKeyAuth
headerx-api-key<token>

API key for authentication. Keys are prefixed with cops_.

Request Body

application/json
  1. body
accountIds*array<>
Items1 <= items
status*string
Value in"active""watching""archived"

Response Body

Response schema unavailable.

Example Request
curl -X PATCH 'https://cops.app/api/brand/accounts/status' \  -H 'Content-Type: application/json' \  -d '{  "accountIds": [    "string"  ],  "status": "active"}'
Example Response200
Empty

Refresh account POST

Queue a manual re-fetch of one account's latest profile data and recent videos from its platform. Runs in the background; poll the account's scrapeStatus for progress. Pass an accountId from list_accounts.

Set account default campaign PUT

Set or clear (campaignId: null) the single default campaign for a tracked account. New videos synced from the account are assigned to this campaign; the account's currently-unassigned videos are assigned immediately. Switching the default is forward-only — videos already assigned to another campaign stay there. Pass an accountId from list_accounts and a campaignId from list_campaigns.