{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"redocly_category":"Customer Data Platform","product_name":"Data Workbench","type":"markdown"},"seo":{"title":"About Pools","description":"Use pools to assign separate concurrency limits to groups of Treasure Workflow attempts so high-volume workflows do not block other workflows from running.","siteUrl":"https://docs.treasure.ai","image":"/assets/treasure-ai-social-preview.e6fefb35676f6da91c2d1bc783bd39e618e7af2b1ad3aa52a96ae69d72e700fe.b1bff462.png","lang":"en-US","jsonLd":{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://www.treasure.ai/","name":"Treasure AI","url":"https://www.treasure.ai/","logo":"https://www.treasure.ai/hubfs/assets/images/logos/primary-logo.svg"},{"@type":"WebSite","@id":"https://docs.treasure.ai/#website","name":"Treasure AI Documentation","url":"https://docs.treasure.ai/","inLanguage":["en","ja"],"publisher":{"@id":"https://www.treasure.ai/"}}]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"about-pools","__idx":0},"children":["About Pools"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A pool lets you control how many of a chosen group of workflow attempts can run in a Treasure AI account at the same time, independently of other workflows. Each pool has its own name and concurrency limit. By creating multiple pools and writing pool rules, an account administrator can guarantee that one group of workflows cannot consume every attempt slot in the account and starve other workflows."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every account starts with a single ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["default pool"]}," that holds the account's full concurrency limit. When you create additional pools, the default pool's concurrency limit is reduced by the new pools' concurrency limits. Each pool has its own concurrency limit and its own queue."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Administrator only"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Pools are configured through the Treasure Workflow API and require administrator permissions. No Data Workbench UI is provided."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-an-attempt-is-assigned-to-a-pool","__idx":1},"children":["How an attempt is assigned to a pool"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When an attempt is created, Treasure Workflow picks a pool by evaluating the account's pool rules in priority order, lowest value first. The first rule whose conditions all match wins, and the attempt is assigned to that rule's pool. If no rule matches, the attempt goes to the default pool. Once assigned, an attempt stays in its pool until it finishes, even if you change the rules later."]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"flowchart LR\n A[Attempt created] --> R{Match a pool rule?}\n R -- yes --> P1[Assigned to rule's pool]\n R -- no --> P0[Assigned to default pool]\n P1 --> C{Pool slot available?}\n P0 --> C\n C -- yes --> RUN[Attempt runs]\n C -- no, queueing allowed --> Q[Attempt queued]\n C -- no, queueing disallowed --> F[Attempt creation fails]\n Q --> RUN\n","diagramHtml":"","diagramHtmlDark":""},"children":["flowchart LR\n A[Attempt created] --> R{Match a pool rule?}\n R -- yes --> P1[Assigned to rule's pool]\n R -- no --> P0[Assigned to default pool]\n P1 --> C{Pool slot available?}\n P0 --> C\n C -- yes --> RUN[Attempt runs]\n C -- no, queueing allowed --> Q[Attempt queued]\n C -- no, queueing disallowed --> F[Attempt creation fails]\n Q --> RUN\n"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a pool's concurrency limit is reached, new attempts are queued or rejected depending on how they were created. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/customer-data-platform/data-workbench/workflows/pool/attempt-queueing"},"children":["Attempt queueing"]}," for the full matrix."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-you-will-set-up","__idx":2},"children":["What you will set up"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To start using pools, perform these tasks in order:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/customer-data-platform/data-workbench/workflows/pool/managing-pools"},"children":["Manage pools"]},": create, update, and delete pools and learn how the default pool's limit is adjusted automatically."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/customer-data-platform/data-workbench/workflows/pool/managing-pool-rules"},"children":["Manage pool rules"]},": write the rules that decide which pool each attempt is assigned to."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/customer-data-platform/data-workbench/workflows/pool/attempt-queueing"},"children":["Understand attempt queueing"]},": learn when an attempt is queued versus rejected when a pool is full."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Review ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/customer-data-platform/data-workbench/workflows/pool/use-cases"},"children":["pool use cases"]}," for two worked examples."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"limits","__idx":3},"children":["Limits"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/requirements-and-limitations/treasure-workflow-prerequisites-and-limitations"},"children":["Treasure Workflow Prerequisites and Limitations"]}," for the maximum number of pools, pool rules, waiting attempts per pool, and the account's total concurrency limit."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-concepts","__idx":4},"children":["Related concepts"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/customer-data-platform/data-workbench/workflows/treasure-workflow-terms-and-concepts"},"children":["Treasure Workflow terms and concepts"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/customer-data-platform/data-workbench/workflows/pool/attempt-queueing"},"children":["Attempt queueing"]}]}]}]},"headings":[{"value":"About Pools","id":"about-pools","depth":1},{"value":"How an attempt is assigned to a pool","id":"how-an-attempt-is-assigned-to-a-pool","depth":2},{"value":"What you will set up","id":"what-you-will-set-up","depth":2},{"value":"Limits","id":"limits","depth":2},{"value":"Related concepts","id":"related-concepts","depth":2}],"frontmatter":{"seo":{"title":"About Pools","description":"Use pools to assign separate concurrency limits to groups of Treasure Workflow attempts so high-volume workflows do not block other workflows from running."}},"lastModified":"2026-05-27T01:36:54.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/customer-data-platform/data-workbench/workflows/pool","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}