# RollWorks API Documentation

This is the complete API documentation for connecting to the RollWorks API using MindCloud's Universal API.

MindCloud offers one normalized API to access 3,400+ apps from a single place. It centralizes authentication and normalizes app APIs so they are easier and more consistent to use.

## Quickstart

1. A **MindCloud account** — sign in or create an account at [MindCloud](https://app.mindcloud.co).
2. A **MindCloud API Key** — create one in [API Keys](https://app.mindcloud.co/user/api-keys). Keep it on your server.
3. At least one **RollWorks connection** — create or choose one in [Connections](https://app.mindcloud.co/credentials). Note its `connectionId`.

```text
POST https://connect.mindcloud.co/v2/universal/apps/rollWorks/actions/{actionSlug}/run
```

## RollWorks actions

- POST `accept-segment-sharing-invitation` Accept Segment Sharing Invitation
- PUT `bulk-create-or-update-segments-by-bulk-route` Bulk Create Or Update Segments by Bulk Route
- PUT `bulk-create-or-update-segments-by-put-route` Bulk Create Or Update Segments by Put Route
- POST `create-icp-by-advertisable-eid` Create ICP by Advertisable EID
- POST `create-segment` Create Segment
- POST `create-segment-sharing-invitation` Create Segment Sharing Invitation
- POST `create-target-accounts-list` Create Target Accounts List
- POST `create-target-accounts-tier` Create Target Accounts Tier
- DELETE `delete-icp-by-icp-eid-and-advertisable-eid` Delete ICP by ICP EID and Advertisable EID
- DELETE `delete-mirror-segment` Delete Mirror Segment
- DELETE `delete-segment` Delete Segment
- DELETE `delete-target-accounts-list` Delete Target Accounts List
- DELETE `delete-target-accounts-list-items-by-delete-route` Delete Target Accounts List Items by Delete Route
- DELETE `delete-target-accounts-list-items-by-post-delete-route` Delete Target Accounts List Items by Post Delete Route
- DELETE `delete-target-accounts-tier` Delete Target Accounts Tier
- GET `estimate-composite-segment-size` Estimate Composite Segment Size
- GET `execute-graphql-queries` Execute GraphQL queries
- GET `get-cdp-plus-user-list-sizes-by-segment-and-date` Get CDP Plus User List Sizes by Segment and Date
- GET `get-domain-references` Get Domain References
- GET `get-exact-user-counts-by-date-and-metric` Get Exact User Counts by Date and Metric
- GET `get-icp-by-icp-eid-and-advertisable-eid` Get ICP by ICP EID and Advertisable EID
- GET `get-segment` Get Segment
- GET `get-source-segment-for-sharing-invitation` Get Source Segment for Sharing Invitation
- GET `get-target-accounts-list` Get Target Accounts List
- GET `get-target-accounts-tier` Get Target Accounts Tier
- GET `get-user-attribute-counts-by-name-and-value` Get User Attribute Counts by Name and Value
- GET `get-user-list-sizes-by-ad-and-date` Get User List Sizes by Ad and Date
- GET `get-user-list-sizes-by-ad-group-and-date` Get User List Sizes by Ad Group and Date
- GET `get-user-list-sizes-by-advertisable-and-date` Get User List Sizes by Advertisable and Date
- GET `get-user-list-sizes-by-segment-and-date-batch` Get User List Sizes by Segment and Date Batch
- GET `get-user-list-sizes-by-segment-and-date-with-summary` Get User List Sizes by Segment and Date with Summary
- GET `list-advertisers` List Advertisers
- GET `list-domains-in-target-account-lists` List Domains in Target Account Lists
- GET `list-icp-accounts-by-advertisable-eid` List ICP Accounts by Advertisable EID
- GET `list-icps-by-advertisable-eid` List ICPs by Advertisable EID
- GET `list-scores-by-tal-eid-and-advertisable-eid` List Scores by TAL EID and Advertisable EID
- GET `list-segments` List Segments
- GET `list-segments-with-general-exclusions` List Segments with General Exclusions
- GET `list-sharing-invitations` List Sharing Invitations
- GET `list-target-accounts-items` List Target Accounts Items
- GET `list-target-accounts-list-names-and-eids` List Target Accounts List Names and EIDs
- GET `list-target-accounts-lists` List Target Accounts Lists
- GET `list-target-accounts-lists-with-general-exclusions` List Target Accounts Lists with General Exclusions
- GET `list-target-accounts-tiers` List Target Accounts Tiers
- GET `list-user-attribute-segments-by-tal-reference` List User Attribute Segments by TAL Reference
- GET `list-user-attributes-by-advertisable` List User Attributes by Advertisable
- GET `list-valid-and-invalid-segments-for-crosschannel-lal-targeting` List Valid and Invalid Segments for Crosschannel LAL Targeting
- PUT `reactivate-segment` Reactivate Segment
- DELETE `revoke-sharing-invitation` Revoke Sharing Invitation
- GET `search-target-accounts-items` Search Target Accounts Items
- PUT `update-icp-by-icp-eid-and-advertisable-eid` Update ICP by ICP EID and Advertisable EID
- PUT `update-or-delete-tag-tal-references` Update Or Delete TAG TAL References
- PUT `update-segment-or-replace-user-list` Update Segment or Replace User List
- PUT `update-target-accounts-list` Update Target Accounts List
- PUT `update-target-accounts-list-items` Update Target Accounts List Items
- PUT `update-target-accounts-tier` Update Target Accounts Tier
- PUT `upsert-target-accounts-list-items` Upsert Target Accounts List Items