COPS
Brand API

Refresh account

POST
/accounts/{accountId}/refresh

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.

Authorization

apiKeyAuth
headerx-api-key<token>

API key for authentication. Keys are prefixed with cops_.

Path Parameters

accountId*string
Match^acct_.+[\s\S]*$

Request Body

application/json
  1. body
maxItems?integer
Range-9007199254740991 <= value <= 5000

Response Body

Response schema unavailable.

Example Request
curl -X POST 'https://cops.app/api/brand/accounts/string/refresh' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response200
Empty

Track account POST

Start tracking one or more social accounts by profile URL for your organization. Auto-links them to the default campaign; optionally pass a campaignId or creatorId to link on creation. Fetches profile + recent videos in the background and returns which URLs were accepted vs. failed.

Set account status PATCH

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.