Listening: sharing & access
Projects other accounts shared with you as a guest
Projects other accounts shared with you as a guest (Shared Campaign): project, role (viewer|analyst), shared_by, owner.name, branding. Only when acting for your personal account (empty in an organization); pending shares to your verified email are claimed
Open a pending share with the emailed token
Open a pending share with the emailed token (proof of the mailbox: works before the address is verified, only for the address it was sent to). Personal account only. 20/min
The acting account's restrict_projects
The acting account's `restrict_projects` (members see only projects they are assigned to) and `can_manage`
Turn per-project restriction on or off
Owner/admin of an organization: turn per-project restriction on or off (audited)
Your role in the project
Your role in the project (viewer|analyst|manager), is_guest, can { view, analyze, verify, manage }, can_manage_members, owner.name, branding
List members (listening › projects)
Manager: account members with their project role (owner/admin are managers of every project), guests (email as typed, role, status invited|joined), restrict_projects
Give an account member a project role
Owner/admin: give an account member a project role. viewer reads; analyst also tags, verifies, comments; manager also settings, sources, campaigns, alerts, reports, sharing (not deleting the project)
Remove the assignment
Owner/admin: remove the assignment
Add guest to project
Manager: share the project with an email (viewer|analyst). Always 202 with the same body whether or not the address has an account; an email goes out either way (its link carries a token that admits sign-up while registration is closed: `invitation_token` on /csl/auth/v1/register). 20/min
Update guest (listening › projects)
Manager: change a guest's role
Delete guest (listening › projects)
Manager: revoke (effective on the guest's next request)
Verify Mentions queue across the projects you may verify
Verify Mentions queue across the projects you may verify (`listening.verify`, or an analyst/manager project role). Newest first; mention + project, type (post|comment), is_verified, verified_by, verified_at, is_irrelevant, review_note; meta.counts { unverified, verified, irrelevant }
Projects you may verify
Projects you may verify (id, name, is_guest)
One action on 1-200 mentions
One action on 1-200 mentions; mentions outside your verifiable projects are skipped (404 when none is left). sentiment and intent (intent_source manual) also verify; irrelevant also verifies and leaves the mention out of analytics and reports. Every change is in the audit trail (before/after) and the owner's activity log
Per reviewer
Per reviewer: reviewed (distinct mentions), verified, sentiment_changes, intent_changes, irrelevant, actions, last_at (?from, to, project_ids; a Y-m-d (or Ymd) from/to is that whole day of the project timezone when one project is in scope (one in project_ids, or the only one you may verify), else the installation default: from its first second, to its last; a date-time with an offset (Z, +07:00) keeps its instant; a date-time without an offset is read as UTC, the stored timezone); queue counts
Audit trail of one mention
Audit trail of one mention: action, changes { field: [before, after] }, user, created_at