Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Administration

Admins manage organization-wide configuration including items, actions, policies, user access, authentication, and integrations settings. All of these settings are accessible under Settings in Coop.

Item Types

Item Types represent the different types of entities on your platform. See Concepts → Item Type for details.

Configuration of an Item Type: a post from the firehose with a schema of fields that get sent to Coop including text, unique ID as well as what format the fields are in

When creating an Item Type, define the schema to include which fields will be included and shown to reviewers. These fields are also available in any rule logic to connect with signals for routing or automation.

Actions

Actions represent anything that can be performed on Items by proactive rules or moderator decisions. See Concepts → Actions for details.

Table of configured custom actions like: send warning, label as spam, delete content, delete account, ban email

Actions are paired with API enpoints on your platform. See Handling Actions for technical details.

Creating an action in Coop: add the name, description, what item types the action can run on, and a callback URL

Policies

Policies are the set of rules and guidelines that a platform uses to govern the conduct of its users. See Concepts → Policy for details.

Policy Dashboard showing 4 policies: Fraud, Nudity, Scams, Spam. There’s a button to create new policies as well as options to add sub-policies for each existing policy and edit or delete them

Policies added in Coop’s UI are visible to reviewers directly in the Job view of the Review Console.

User management

Coop uses role-based access controls to ensure the right people can access the right data.

User management page in Coop showing different users with different emails and roles assigned to them. There is an Approval Status column and a column showing when they were created

You can invite users from Settings → Users, either copying the invite link to share directly or configuring an email service to send it automatically.

Coop’s user invitation flow

Roles

Coop comes with seven predefined roles:

User RoleAccess Review ConsoleView all QueuesCreate, Delete and Edit QueuesCreate, Delete and Edit RulesAccess NCMEC dataAccess Insights
AdminYesYesYesYesYesYes
Rules ManagerNoNoNoYesNoYes
Moderator ManagerYesYesYesNoYesNo
Child Safety ModeratorYesNoNoNoYesNo
ModeratorYesNoNoNoNoNo
AnalystNoNoNoNoNoYes
External ModeratorYesNoNoNoNoNo

Admin: manage the entire organization. They have full control over all resources and settings within Coop.

Rules Manager: can create, edit, and deploy Live Rules, run retroaction and backtests, view rule insights, manage policies, use the Investigation tool, and bulk-action content. They cannot manage users, queues, or other organization-level settings.

Moderator Manager: can view and edit all queues within the Review Console, manage moderator permissions, use the Investigation tool, and bulk-action content. They can also view child safety data.

Child Safety Moderator: the same permissions as Moderators, but can also review Child Safety jobs and see previous Child Safety decisions.

Moderator: can access the Review Console, but can only review jobs from queues they’ve been given permission to see. They cannot see any Child Safety-related jobs or decisions.

Analyst: can modify and test Draft and Background Rules, run backtests, and view rule insights and the Investigation tool. They cannot create or edit Live Rules, run Retroaction, or access the Review Console.

External Moderator: can only review jobs in the Review Console. They cannot see any decisions or use any other tooling.

SSO

Coop supports single sign-on via SAML, e.g. with Okta.

Example: Okta

Configuring Okta SAML for Coop requires:

  • Admin mode in Okta
  • Group names that match exactly between Okta and SAML
  • Admin permissions in Coop
  • Ability to create a custom SAML application

To set it up:

  1. Create a custom SAML application in Okta with the following settings:

    SettingValue
    Single sign-on URLYour organization’s callback URL (e.g. https://your-coop-instance.com/login/saml/12345/callback). Find this in Coop under Settings → SSO.
    Audience URI (SP Entity ID)Your Coop instance base URL (e.g. https://your-coop-instance.com).
    email attribute (in Attribute Statements)email. This depends on your identity provider’s attribute mappings (e.g. Google SSO may use “Primary Email”).
  2. In the Feedback tab, check I’m a software vendor. I’d like to integrate my app with Okta.

  3. In your app’s settings, go to the Sign On tab. Under SAML Signing Certificates → SHA-2, click Actions → View IdP metadata.

  4. Copy the contents of the XML file. In Coop, go to Settings → SSO and paste the XML into the Identity Provider Metadata field.

  5. On the same page, enter email in the Attributes section.

  6. In your Okta app under Assignments, assign users or groups to your app.

API Keys

Coop uses API keys to authenticate requests between your platform and Coop.

Coop API key

To authenticate requests your platform sends to Coop, include your organization’s API key as an HTTP header on every request. You can find or rotate your key in SettingsAPI Keys.

X-API-KEY: <<apiKey>>
Content-Type: application/json

To verify that incoming requests to your Action endpoints were sent by Coop, use the webhook signature verification key shown in Settings → API Keys. See API Keys and Authentication in the Development Guide for implementation details.