Account monitoring
See and control which accounts are monitored.
Monitoring is how Sillage keeps watching an account for signals. It is invoiced to you per account, per persona, per month, at your partner price. There is no credit balance to top up. A persona is identified by persona_id: see Personas.
Monitoring is set with signal_buckets: ["essential"] monitors an account (mapping, signals and content), null means not monitored.
Endpoints
| Method | Path | Description |
|---|---|---|
| GET | /api/v3/partner/workspaces/{partner_workspace_id}/account-monitoring | Get monitoring summary: how many accounts are monitored, what they cost. |
| PUT | /api/v3/partner/workspaces/{partner_workspace_id}/account-monitoring/accounts | Monitor or stop accounts: start or stop monitoring a selection of accounts in one persona. |
Statuses
Every account has one status in a persona. A partner never sees not_covered: renewals are invoiced, so they are never refused.
| Status | Meaning |
|---|---|
| monitored | The account is monitored in this persona and its month is running. |
| monitored_elsewhere | The account is monitored in another persona only. |
| not_monitored | The account is not monitored in this persona. If it was stopped during an invoiced month, covered_until shows when its signals end. |
Read monitoring
- Get monitoring summary: how many accounts are monitored, what they cost.
- List members: on customer and prospect lists, each member carries
monitoring, one entry per persona with itsstatus,covered_untilandnot_covered_since. Filter withmonitoring_statusand narrow to one persona withpersona_id. - Monitor or stop accounts: each account in
changedcomes back with its newstatusandcovered_until, so you can read the result without a second call.
Change monitoring
- Monitor or stop accounts: a selection of accounts in one persona.
- Monitor or stop a whole list, including the accounts that join it later: send
signal_bucketswithPATCH /api/v3/partner/workspaces/{partner_workspace_id}/lists/{kind}/{list_id}.nullstops the whole list, including the accounts picked one by one. Each list also reportssignal_bucketsandmonitoring_by_persona: for each persona, how many accounts are monitored.
A list attached to several personas invoices each of them, and stopping an account on it stops it in each of them. Stopping never credits back the month already invoiced.