Counts definitions using the same filters, disabled-definition default, archived exclusion, and employee analytics access rules as the stat definition search. Counts each definition once, regardless of how many employees or stat rows match. Pagination does not affect the count.
Use an API key or OAuth access token. Enter only the token in the authorization dialog; requests send it as Authorization: Bearer <TOKEN>.
Create an API key in your workspace's Settings → API keys. Keys start with wm_api_ and only work in the workspace where they were created. Read-only keys can read data; creating, updating, or deleting data requires a read-write key.
Authorization: Bearer wm_api_example
OAuth access tokens are issued for connected Windmill applications.
Authorization: Bearer <OAUTH_ACCESS_TOKEN>
Both token types use the authenticated user's workspace permissions. Each endpoint's permission requirements and the sharing settings of the requested items still apply.
Path Parameters
companyId
string
required
Company ID. A URL slug is also accepted. The caller must have access to this company.
Required string length: 1 - 128
Example:
"company-acme"
Body
application/json
ids
string<uuid>[]
Match any of these stat definition UUIDs. Omitted or empty adds no restriction.
Maximum array length: 100
Example:
["11111111-1111-4111-8111-111111111111"]
statTypes
string[]
Match any of these stat identifiers. Omitted or empty adds no restriction.
Maximum array length: 100
Kebab-case identifier of a global Windmill stat or a workspace custom stat. Discover identifiers with POST /c/{companyId}/stats/metadata/search.
Required string length: 1 - 100
Pattern: ^[a-z0-9]+(-[a-z0-9]+)*$
Example:
["code-prs-merged"]
valueTypes
enum<string>[]
Match any selected aggregation type. Omitted or empty matches all value types.
Maximum array length: 3
How stat values aggregate over a period: COUNT sums event counts, AGGREGATE sums measured values and counts a denominator, AVERAGE is a denominator-weighted per-unit ratio.
Available options:
COUNT,
AGGREGATE,
AVERAGE
Example:
["COUNT"]
search
string
Case-insensitive literal text matched within the identifier, label, or description. Regular expressions and wildcard patterns are not interpreted.
Maximum string length: 200
Example:
"pull request"
isGlobal
boolean
True selects global Windmill-managed definitions; false selects this workspace's custom definitions. Omit to include both.
Example:
true
includeDisabled
boolean
default:false
Include disabled definitions alongside enabled ones. Archived definitions never match.
Example:
false
employee
Employees with stat data · object
Return only definitions with at least one recorded stat value for a matching employee whose analytics the caller can read. Any recorded date qualifies, including values of zero. Omit to list definitions even without recorded data; an empty object applies the default employee filter. This filter never expands employee access.
Show child attributes
Example:
{ "status": "CURRENT", "query": "Avery" }
Response
Number of matching stat definitions
total
integer
required
Total matching items, independent of pagination. The route determines the item type.
Required range: x >= 0
Example:
1
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Windmill Help Site","colors":{"primary":"#4084FB","light":"#7aadff","dark":"#1758c1"},"logo":{"light":"https://mintcdn.com/windmill/438SkEPmWnjrcDyT/logo/light.svg?fit=max\u0026auto=format\u0026n=438SkEPmWnjrcDyT\u0026q=85\u0026s=911e75d2985851400d148f9e5e20c94f","dark":"https://mintcdn.com/windmill/438SkEPmWnjrcDyT/logo/dark.svg?fit=max\u0026auto=format\u0026n=438SkEPmWnjrcDyT\u0026q=85\u0026s=3942c2e1a12a8a71050cdb71a6613cf0"},"favicon":"https://mintcdn.com/windmill/438SkEPmWnjrcDyT/favicon.svg?fit=max\u0026auto=format\u0026n=438SkEPmWnjrcDyT\u0026q=85\u0026s=d0f6bb9380e55bd874dafc8c7a0bf0cc","navbar":{"links":[{"href":"mailto:support@gowindmill.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.gowindmill.com"}},"footer":{"socials":{"x":"https://x.com/trywindmill","linkedin":"https://www.linkedin.com/company/gowindmill"}},"seo":{"metatags":{"og:site_name":"Windmill Help Center"}},"contextual":{"options":["copy","view"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"windmill","hasAudioNarration":false,"actualSubdomain":"windmill","customDomains":["help.gowindmill.com"],"gitSource":{"type":"github","owner":"windmill-dev","repo":"windmill-help","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b009665dfebac270846c193","clientVersion":"0.0.4248","searchFilterCounts":[{"language":"default","tag":"Platform","count":144},{"language":"default","tag":"API reference","count":64},{"language":"default","tag":"Endpoints","count":55},{"language":"default","tag":"Review Cycles","count":51},{"language":"default","tag":"Integrations","count":44},{"language":"default","tag":"Productivity","count":30},{"language":"default","tag":"Pulse surveys","count":28},{"language":"default","tag":"Groups","count":23},{"language":"default","tag":"Features","count":17},{"language":"default","tag":"Getting started","count":16}]},"assistantConfig":{"enableAskAiButton":true,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"loom-embed.css","content":"[data-loom]{position:relative;aspect-ratio:16 / 9;background:#000;border-radius:0.75rem;overflow:hidden;margin-bottom:1rem}[data-loom]>a{position:absolute;inset:0;display:block}[data-loom] img{width:100%;height:100%;margin:0;border-radius:0;object-fit:contain;object-position:center}[data-loom]::before{content:attr(data-title);position:absolute;inset:0;z-index:1;pointer-events:none;padding:1rem 1.25rem;color:#fff;font-weight:600;font-size:1.25rem;line-height:1.25;text-shadow:0 1px 4px rgba(0, 0, 0, 0.4);background:linear-gradient(\n to bottom,\n rgba(0, 0, 0, 0.75) 0%,\n rgba(0, 0, 0, 0.28) 45%,\n rgba(0, 0, 0, 0.28) 100%\n );transition:opacity 0.5s}[data-loom][data-duration]::after{content:attr(data-duration);position:absolute;bottom:0.75rem;right:0.75rem;z-index:1;pointer-events:none;border-radius:0.375rem;background:rgba(0, 0, 0, 0.7);padding:0.125rem 0.5rem;font-size:0.75rem;font-weight:500;font-variant-numeric:tabular-nums;color:#fff;transition:opacity 0.5s}[data-loom]>a::after{content:\"\";position:absolute;inset:0;z-index:1;margin:auto;width:clamp(72px, 15%, 124px);aspect-ratio:1;border-radius:100%;box-shadow:0 1px 6px rgba(0, 0, 0, 0.25);background:url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 90 90' fill='none'%3E%3Cpath fill='%23ffffff' opacity='0.3' d='M45 90C69.8529 90 90 69.8527 90 44.9999C90 20.1471 69.8529 0 45 0C20.1472 0 0 20.1471 0 44.9999C0 69.8527 20.1472 90 45 90Z'/%3E%3Cpath fill='%23ffffff' d='M45 85C67.0914 85 85 67.0913 85 44.9999C85 22.9086 67.0914 5 45 5C22.9086 5 5 22.9086 5 44.9999C5 67.0913 22.9086 85 45 85Z'/%3E%3Cpath fill='%23000000' opacity='0.8' d='M35 33.268V56.732C35 58.5212 37.0582 59.6083 38.6432 58.6344L57.8999 46.9025C59.3667 46.0192 59.3667 43.9808 57.8999 43.0749L38.6432 31.3656C37.0582 30.3917 35 31.4788 35 33.268Z'/%3E%3C/svg%3E\")\n center / contain no-repeat;transition:transform 0.2s, opacity 0.5s}[data-loom]:hover>a::after,[data-loom]:focus-within>a::after{transform:scale(1.1)}[data-loom]>iframe{position:absolute;inset:0;width:100%;height:100%;z-index:2;border:0;opacity:0;pointer-events:none;transition:opacity 0.5s}[data-loom][data-playing]>iframe{opacity:1;pointer-events:auto}[data-loom][data-playing]::before,[data-loom][data-playing]::after,[data-loom][data-playing]>a::after{opacity:0}[data-loom]>button{position:absolute;inset:0;width:100%;height:100%;z-index:3;cursor:pointer;background:transparent;border:0;padding:0}"}]}
{"page":{"pagePath":"api-reference/stats/count-stat-definitions","slug":"/api-reference/stats/count-stat-definitions","pageMetadata":{"title":"Count stat definitions","description":"Counts definitions using the same filters, disabled-definition default, archived exclusion, and employee analytics access rules as the stat definition search. Counts each definition once, regardless of how many employees or stat rows match. Pagination does not affect the count.","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json post /c/{companyId}/stats/metadata/count","href":"/api-reference/stats/count-stat-definitions","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Counts definitions using the same filters, disabled-definition default, archived exclusion, and employee analytics access rules as the stat definition search. Counts each definition once, regardless of how many employees or stat rows match. Pagination does not affect the count.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Count stat definitions","description":"Counts definitions using the same filters, disabled-definition default, archived exclusion, and employee analytics access rules as the stat definition search. Counts each definition once, regardless of how many employees or stat rows match. Pagination does not affect the count.","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json post /c/{companyId}/stats/metadata/count","href":"/api-reference/stats/count-stat-definitions","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"stats.metadata.count","summary":"Count stat definitions","description":"Counts definitions using the same filters, disabled-definition default, archived exclusion, and employee analytics access rules as the stat definition search. Counts each definition once, regardless of how many employees or stat rows match. Pagination does not affect the count.","tags":["Stats"],"security":["d3d68fbb-38f5-4070-a1b2-4e657046ea88"],"parameters":["229ac4de-edc6-45a5-9e95-a46325e9fe09"],"requestBody":"9bc0543a-e66b-48e2-b543-ca912b56aa84","responses":{"200":"ef36dcfd-7ee0-44f4-b550-2f179d33c016","400":"f7926080-c1ec-4790-88b1-385427e65837","401":"ea2a31de-7ab9-487b-a547-292d42b87e4c","403":"8753fb35-0e40-4d77-8348-b1f4194da743","404":"c954dbd0-a64e-4ab5-b759-c978722b5f4c","429":"6e6b63e9-e93d-4c6c-9639-edfd768962f6"},"method":"post","type":"path","servers":["c9e274ea-babc-40ce-84c8-2205f0a915c6"],"path":"/c/{companyId}/stats/metadata/count","baseUrlOptions":["https://api.gowindmill.com/api/v2"],"title":"Count stat definitions","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"229ac4de-edc6-45a5-9e95-a46325e9fe09":{"schema":{"type":"string","minLength":1,"maxLength":128,"description":"Company ID. A URL slug is also accepted. The caller must have access to this company.","title":"Company ID","example":"company-acme","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true,"description":"Company ID. A URL slug is also accepted. The caller must have access to this company.","name":"companyId","in":"path"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"ids.items.[INDEX]","typeLabel":"string\u003cuuid>"},"maxItems":100,"description":"Match any of these stat definition UUIDs. Omitted or empty adds no restriction.","title":"Stat definition IDs","example":["11111111-1111-4111-8111-111111111111"],"uniqueKey":"ids","typeLabel":"string\u003cuuid>[]"},"statTypes":{"type":"array","items":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","description":"Kebab-case identifier of a global Windmill stat or a workspace custom stat. Discover identifiers with POST /c/{companyId}/stats/metadata/search.","title":"Stat identifier","example":"code-prs-merged","uniqueKey":"statTypes.items.[INDEX]","typeLabel":"string"},"maxItems":100,"description":"Match any of these stat identifiers. Omitted or empty adds no restriction.","title":"Stat identifiers","example":["code-prs-merged"],"uniqueKey":"statTypes","typeLabel":"string[]"},"valueTypes":{"type":"array","items":{"type":"string","enum":["COUNT","AGGREGATE","AVERAGE"],"description":"How stat values aggregate over a period: COUNT sums event counts, AGGREGATE sums measured values and counts a denominator, AVERAGE is a denominator-weighted per-unit ratio.","title":"Value type","example":"COUNT","uniqueKey":"valueTypes.items.[INDEX]","typeLabel":"enum\u003cstring>"},"maxItems":3,"description":"Match any selected aggregation type. Omitted or empty matches all value types.","title":"Value types","example":["COUNT"],"uniqueKey":"valueTypes","typeLabel":"enum\u003cstring>[]"},"search":{"type":"string","maxLength":200,"description":"Case-insensitive literal text matched within the identifier, label, or description. Regular expressions and wildcard patterns are not interpreted.","title":"Search text","example":"pull request","uniqueKey":"search","typeLabel":"string"},"isGlobal":{"type":"boolean","description":"True selects global Windmill-managed definitions; false selects this workspace's custom definitions. Omit to include both.","title":"Global definitions","example":true,"uniqueKey":"isGlobal","typeLabel":"boolean"},"includeDisabled":{"type":"boolean","default":false,"description":"Include disabled definitions alongside enabled ones. Archived definitions never match.","title":"Include disabled definitions","example":false,"uniqueKey":"includeDisabled","typeLabel":"boolean"},"employee":{"type":"object","title":"Employees with stat data","description":"Return only definitions with at least one recorded stat value for a matching employee whose analytics the caller can read. Any recorded date qualifies, including values of zero. Omit to list definitions even without recorded data; an empty object applies the default employee filter. This filter never expands employee access.","example":{"status":"CURRENT","query":"Avery"},"properties":{"hasDirectReports":{"oneOf":[{"type":"boolean","description":"True selects managers with a direct report; false selects employees without direct reports.","title":"Has direct reports","example":true,"uniqueKey":"employee.hasDirectReports.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"True selects managers with a direct report; false selects employees without direct reports.","title":"Has direct reports","example":true,"uniqueKey":"employee.hasDirectReports.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.hasDirectReports","typeLabel":"boolean | null"},"hasManager":{"oneOf":[{"type":"boolean","description":"True selects employees with an assigned manager; false selects employees without a manager.","title":"Has a manager","example":true,"uniqueKey":"employee.hasManager.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"True selects employees with an assigned manager; false selects employees without a manager.","title":"Has a manager","example":true,"uniqueKey":"employee.hasManager.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.hasManager","typeLabel":"boolean | null"},"employeeGroupId":{"oneOf":[{"type":"string","minLength":1,"maxLength":128,"description":"Select employees belonging to this employee group.","title":"Employee group ID","example":"group-engineering","uniqueKey":"employee.employeeGroupId.oneOf.0","typeLabel":"string"},{"type":"null","minLength":1,"maxLength":128,"description":"Select employees belonging to this employee group.","title":"Employee group ID","example":"group-engineering","uniqueKey":"employee.employeeGroupId.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.employeeGroupId","typeLabel":"string | null"},"employeeGroupIds":{"oneOf":[{"type":"array","items":{"type":"string","minLength":1,"maxLength":128,"uniqueKey":"employee.employeeGroupIds.oneOf.0.items.[INDEX]","typeLabel":"string"},"maxItems":1000,"description":"Select members of any listed employee group. Up to 1000 IDs.","title":"Employee group IDs","example":["group-engineering"],"uniqueKey":"employee.employeeGroupIds.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":1000,"description":"Select members of any listed employee group. Up to 1000 IDs.","title":"Employee group IDs","example":["group-engineering"],"uniqueKey":"employee.employeeGroupIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.employeeGroupIds","typeLabel":"string[] | null"},"jobTitle":{"oneOf":[{"type":"string","maxLength":256,"description":"Select employees whose job title exactly matches this value.","title":"Exact job title","example":"Engineer","uniqueKey":"employee.jobTitle.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":256,"description":"Select employees whose job title exactly matches this value.","title":"Exact job title","example":"Engineer","uniqueKey":"employee.jobTitle.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.jobTitle","typeLabel":"string | null"},"jobTitles":{"oneOf":[{"type":"array","items":{"type":"string","maxLength":256,"uniqueKey":"employee.jobTitles.oneOf.0.items.[INDEX]","typeLabel":"string"},"maxItems":1000,"description":"Select employees whose job title exactly matches any listed value. Up to 1000 titles.","title":"Exact job titles","example":["Engineer","Designer"],"uniqueKey":"employee.jobTitles.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string","maxLength":256},"maxItems":1000,"description":"Select employees whose job title exactly matches any listed value. Up to 1000 titles.","title":"Exact job titles","example":["Engineer","Designer"],"uniqueKey":"employee.jobTitles.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.jobTitles","typeLabel":"string[] | null"},"countries":{"oneOf":[{"type":"array","items":{"type":"string","minLength":1,"maxLength":128,"uniqueKey":"employee.countries.oneOf.0.items.[INDEX]","typeLabel":"string"},"maxItems":1000,"description":"Select employees whose HRIS work country matches any listed country code. Up to 1000 values.","title":"Work countries","example":["US"],"uniqueKey":"employee.countries.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":1000,"description":"Select employees whose HRIS work country matches any listed country code. Up to 1000 values.","title":"Work countries","example":["US"],"uniqueKey":"employee.countries.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.countries","typeLabel":"string[] | null"},"emails":{"oneOf":[{"type":"array","items":{"type":"string","maxLength":320,"format":"email","uniqueKey":"employee.emails.oneOf.0.items.[INDEX]","typeLabel":"string\u003cemail>"},"maxItems":1000,"description":"Select employees associated with any listed email address. Up to 1000 valid addresses.","title":"Employee email addresses","example":["avery@example.test"],"uniqueKey":"employee.emails.oneOf.0","typeLabel":"string\u003cemail>[]"},{"type":"null","items":{"type":"string","maxLength":320,"format":"email"},"maxItems":1000,"description":"Select employees associated with any listed email address. Up to 1000 valid addresses.","title":"Employee email addresses","example":["avery@example.test"],"uniqueKey":"employee.emails.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.emails","typeLabel":"string\u003cemail>[] | null"},"emailDomains":{"oneOf":[{"type":"array","items":{"type":"string","maxLength":254,"uniqueKey":"employee.emailDomains.oneOf.0.items.[INDEX]","typeLabel":"string"},"maxItems":1000,"description":"Select employees with an email address on any listed domain. A domain matches exactly, so subdomains are listed separately. Up to 1000 values.","title":"Employee email domains","example":["example.test"],"uniqueKey":"employee.emailDomains.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string","maxLength":254},"maxItems":1000,"description":"Select employees with an email address on any listed domain. A domain matches exactly, so subdomains are listed separately. Up to 1000 values.","title":"Employee email domains","example":["example.test"],"uniqueKey":"employee.emailDomains.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.emailDomains","typeLabel":"string[] | null"},"employeeId":{"oneOf":[{"type":"string","minLength":1,"maxLength":128,"description":"Select a single employee by ID.","title":"Employee ID","example":"employee-avery","uniqueKey":"employee.employeeId.oneOf.0","typeLabel":"string"},{"type":"null","minLength":1,"maxLength":128,"description":"Select a single employee by ID.","title":"Employee ID","example":"employee-avery","uniqueKey":"employee.employeeId.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.employeeId","typeLabel":"string | null"},"employeeIds":{"oneOf":[{"type":"array","items":{"type":"string","minLength":1,"maxLength":128,"uniqueKey":"employee.employeeIds.oneOf.0.items.[INDEX]","typeLabel":"string"},"maxItems":1000,"description":"Select employees with any listed ID. Up to 1000 IDs.","title":"Employee IDs","example":["employee-avery"],"uniqueKey":"employee.employeeIds.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":1000,"description":"Select employees with any listed ID. Up to 1000 IDs.","title":"Employee IDs","example":["employee-avery"],"uniqueKey":"employee.employeeIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.employeeIds","typeLabel":"string[] | null"},"excludedEmployeeId":{"oneOf":[{"type":"string","minLength":1,"maxLength":128,"description":"Exclude this employee from the results.","title":"Excluded employee ID","example":"employee-excluded","uniqueKey":"employee.excludedEmployeeId.oneOf.0","typeLabel":"string"},{"type":"null","minLength":1,"maxLength":128,"description":"Exclude this employee from the results.","title":"Excluded employee ID","example":"employee-excluded","uniqueKey":"employee.excludedEmployeeId.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.excludedEmployeeId","typeLabel":"string | null"},"excludedEmployeeIds":{"oneOf":[{"type":"array","items":{"type":"string","minLength":1,"maxLength":128,"uniqueKey":"employee.excludedEmployeeIds.oneOf.0.items.[INDEX]","typeLabel":"string"},"maxItems":1000,"description":"Exclude employees with any listed ID. Use this field for exclusions in API bulk mutations. Up to 1000 IDs.","title":"Excluded employee IDs","example":["employee-excluded"],"uniqueKey":"employee.excludedEmployeeIds.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":1000,"description":"Exclude employees with any listed ID. Use this field for exclusions in API bulk mutations. Up to 1000 IDs.","title":"Excluded employee IDs","example":["employee-excluded"],"uniqueKey":"employee.excludedEmployeeIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.excludedEmployeeIds","typeLabel":"string[] | null"},"managerId":{"oneOf":[{"type":"string","minLength":1,"maxLength":128,"description":"Select direct reports of this manager; exclude deeper reports.","title":"Direct manager ID","example":"employee-morgan","uniqueKey":"employee.managerId.oneOf.0","typeLabel":"string"},{"type":"null","minLength":1,"maxLength":128,"description":"Select direct reports of this manager; exclude deeper reports.","title":"Direct manager ID","example":"employee-morgan","uniqueKey":"employee.managerId.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.managerId","typeLabel":"string | null"},"managerIds":{"oneOf":[{"type":"array","items":{"type":"string","minLength":1,"maxLength":128,"uniqueKey":"employee.managerIds.oneOf.0.items.[INDEX]","typeLabel":"string"},"maxItems":1000,"description":"Select direct reports of any listed manager, at depth 1. Up to 1000 manager IDs.","title":"Direct manager IDs","example":["employee-morgan"],"uniqueKey":"employee.managerIds.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":1000,"description":"Select direct reports of any listed manager, at depth 1. Up to 1000 manager IDs.","title":"Direct manager IDs","example":["employee-morgan"],"uniqueKey":"employee.managerIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.managerIds","typeLabel":"string[] | null"},"ancestorManagerId":{"oneOf":[{"type":"string","minLength":1,"maxLength":128,"description":"Select direct and indirect reports below this manager at any depth.","title":"Ancestor manager ID","example":"employee-morgan","uniqueKey":"employee.ancestorManagerId.oneOf.0","typeLabel":"string"},{"type":"null","minLength":1,"maxLength":128,"description":"Select direct and indirect reports below this manager at any depth.","title":"Ancestor manager ID","example":"employee-morgan","uniqueKey":"employee.ancestorManagerId.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.ancestorManagerId","typeLabel":"string | null"},"ancestorManagerIds":{"oneOf":[{"type":"array","items":{"type":"string","minLength":1,"maxLength":128,"uniqueKey":"employee.ancestorManagerIds.oneOf.0.items.[INDEX]","typeLabel":"string"},"maxItems":1000,"description":"Select anyone below any listed manager, at depth 1 or greater. Up to 1000 manager IDs.","title":"Ancestor manager IDs","example":["employee-morgan"],"uniqueKey":"employee.ancestorManagerIds.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":1000,"description":"Select anyone below any listed manager, at depth 1 or greater. Up to 1000 manager IDs.","title":"Ancestor manager IDs","example":["employee-morgan"],"uniqueKey":"employee.ancestorManagerIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.ancestorManagerIds","typeLabel":"string[] | null"},"indirectManagerId":{"oneOf":[{"type":"string","minLength":1,"maxLength":128,"description":"Select reports at depth 2 or greater below this manager; exclude direct reports.","title":"Indirect manager ID","example":"employee-morgan","uniqueKey":"employee.indirectManagerId.oneOf.0","typeLabel":"string"},{"type":"null","minLength":1,"maxLength":128,"description":"Select reports at depth 2 or greater below this manager; exclude direct reports.","title":"Indirect manager ID","example":"employee-morgan","uniqueKey":"employee.indirectManagerId.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.indirectManagerId","typeLabel":"string | null"},"indirectManagerIds":{"oneOf":[{"type":"array","items":{"type":"string","minLength":1,"maxLength":128,"uniqueKey":"employee.indirectManagerIds.oneOf.0.items.[INDEX]","typeLabel":"string"},"maxItems":1000,"description":"Select reports at depth 2 or greater below any listed manager. Up to 1000 manager IDs.","title":"Indirect manager IDs","example":["employee-morgan"],"uniqueKey":"employee.indirectManagerIds.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":1000,"description":"Select reports at depth 2 or greater below any listed manager. Up to 1000 manager IDs.","title":"Indirect manager IDs","example":["employee-morgan"],"uniqueKey":"employee.indirectManagerIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.indirectManagerIds","typeLabel":"string[] | null"},"isMember":{"oneOf":[{"type":"boolean","description":"True selects employees with active workspace membership; false selects employees without a member link or with inactive membership.","title":"Has active workspace membership","example":true,"uniqueKey":"employee.isMember.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"True selects employees with active workspace membership; false selects employees without a member link or with inactive membership.","title":"Has active workspace membership","example":true,"uniqueKey":"employee.isMember.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.isMember","typeLabel":"boolean | null"},"memberRole":{"oneOf":[{"type":"string","enum":["admin","hr-admin","integration-manager","data-analyst","team-member",null],"description":"Select employees associated with this workspace member role.","title":"Workspace role","example":"team-member","uniqueKey":"employee.memberRole.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["admin","hr-admin","integration-manager","data-analyst","team-member",null],"description":"Select employees associated with this workspace member role.","title":"Workspace role","example":"team-member","uniqueKey":"employee.memberRole.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.memberRole","typeLabel":"enum\u003cstring> | null"},"query":{"oneOf":[{"type":"string","maxLength":256,"description":"Search employee names, preferred names, and the part of each employee email before the @. Names also match close spellings. Job titles and email domains are not searched; use jobTitle to filter by title. A top-level query controls the default relevance ordering.","title":"Employee search text","example":"Avery","uniqueKey":"employee.query.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":256,"description":"Search employee names, preferred names, and the part of each employee email before the @. Names also match close spellings. Job titles and email domains are not searched; use jobTitle to filter by title. A top-level query controls the default relevance ordering.","title":"Employee search text","example":"Avery","uniqueKey":"employee.query.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.query","typeLabel":"string | null"},"platformAccess":{"oneOf":[{"type":"string","enum":["HAS_ACCESS","INVITE_PENDING","NO_ACCESS",null],"description":"HAS_ACCESS selects active access; INVITE_PENDING selects pending invitations; NO_ACCESS selects employees without access.","title":"Workspace access status","example":"HAS_ACCESS","uniqueKey":"employee.platformAccess.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["HAS_ACCESS","INVITE_PENDING","NO_ACCESS",null],"description":"HAS_ACCESS selects active access; INVITE_PENDING selects pending invitations; NO_ACCESS selects employees without access.","title":"Workspace access status","example":"HAS_ACCESS","uniqueKey":"employee.platformAccess.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.platformAccess","typeLabel":"enum\u003cstring> | null"},"startDate":{"oneOf":[{"type":"object","title":"Start-date range","description":"Select start dates within inclusive date bounds or a supported named date range.","required":["range"],"properties":{"range":{"type":"string","minLength":1,"maxLength":128,"isRequired":true,"uniqueKey":"employee.startDate.oneOf.0.range","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"employee.startDate.oneOf.0","typeLabel":"Start-date range · object"},{"type":"object","title":"Start-date range","description":"Select start dates within inclusive date bounds or a supported named date range.","example":{"from":"2025-01-01","to":"2025-12-31"},"properties":{"from":{"oneOf":[{"type":"string","description":"ISO 8601 date or datetime. Inclusive lower bound.","format":"date","uniqueKey":"employee.startDate.oneOf.1.from.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"string","description":"ISO 8601 date or datetime. Inclusive lower bound.","format":"date-time","uniqueKey":"employee.startDate.oneOf.1.from.oneOf.1","typeLabel":"string\u003cdate-time>"}],"uniqueKey":"employee.startDate.oneOf.1.from","typeLabel":"string\u003cdate> | string\u003cdate-time>"},"to":{"oneOf":[{"type":"string","description":"ISO 8601 date or datetime. Inclusive upper bound.","format":"date","uniqueKey":"employee.startDate.oneOf.1.to.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"string","description":"ISO 8601 date or datetime. Inclusive upper bound.","format":"date-time","uniqueKey":"employee.startDate.oneOf.1.to.oneOf.1","typeLabel":"string\u003cdate-time>"}],"uniqueKey":"employee.startDate.oneOf.1.to","typeLabel":"string\u003cdate> | string\u003cdate-time>"}},"additionalProperties":false,"uniqueKey":"employee.startDate.oneOf.1","typeLabel":"Start-date range · object"},{"type":"null","title":"Start-date range","description":"Select start dates within inclusive date bounds or a supported named date range.","example":{"from":"2025-01-01","to":"2025-12-31"},"uniqueKey":"employee.startDate.oneOf.2","typeLabel":"null"}],"uniqueKey":"employee.startDate","typeLabel":"Start-date range · object · Start-date range · object · null"},"isAccountAdmin":{"oneOf":[{"type":"boolean","description":"True selects account administrators; false selects employees who are not account administrators.","title":"Account administrator","example":false,"uniqueKey":"employee.isAccountAdmin.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"True selects account administrators; false selects employees who are not account administrators.","title":"Account administrator","example":false,"uniqueKey":"employee.isAccountAdmin.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.isAccountAdmin","typeLabel":"boolean | null"},"hasIntegrationIds":{"oneOf":[{"type":"array","items":{"type":"string","minLength":1,"maxLength":128,"uniqueKey":"employee.hasIntegrationIds.oneOf.0.items.[INDEX]","typeLabel":"string"},"maxItems":1000,"description":"Select employees linked to every listed integration identifier. Up to 1000 IDs.","title":"Linked integrations","example":["slack"],"uniqueKey":"employee.hasIntegrationIds.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":1000,"description":"Select employees linked to every listed integration identifier. Up to 1000 IDs.","title":"Linked integrations","example":["slack"],"uniqueKey":"employee.hasIntegrationIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.hasIntegrationIds","typeLabel":"string[] | null"},"lacksIntegrationIds":{"oneOf":[{"type":"array","items":{"type":"string","minLength":1,"maxLength":128,"uniqueKey":"employee.lacksIntegrationIds.oneOf.0.items.[INDEX]","typeLabel":"string"},"maxItems":1000,"description":"Select employees without links to the listed integration identifiers. Up to 1000 IDs.","title":"Unlinked integrations","example":["slack"],"uniqueKey":"employee.lacksIntegrationIds.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":1000,"description":"Select employees without links to the listed integration identifiers. Up to 1000 IDs.","title":"Unlinked integrations","example":["slack"],"uniqueKey":"employee.lacksIntegrationIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.lacksIntegrationIds","typeLabel":"string[] | null"},"status":{"type":"string","enum":["CURRENT","FORMER","ALL"],"default":"CURRENT","description":"CURRENT selects unarchived employees, FORMER selects archived employees, and ALL includes both. Defaults to CURRENT.","title":"Employment status","example":"CURRENT","uniqueKey":"employee.status","typeLabel":"enum\u003cstring>"},"and":{"type":"array","items":{"type":"object","properties":{"hasDirectReports":{"oneOf":[{"type":"boolean","description":"True selects managers with a direct report; false selects employees without direct reports.","title":"Has direct reports","example":true,"uniqueKey":"employee.and.items.[INDEX].hasDirectReports.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"True selects managers with a direct report; false selects employees without direct reports.","title":"Has direct reports","example":true,"uniqueKey":"employee.and.items.[INDEX].hasDirectReports.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.and.items.[INDEX].hasDirectReports","typeLabel":"boolean | null"},"hasManager":{"oneOf":[{"type":"boolean","description":"True selects employees with an assigned manager; false selects employees without a manager.","title":"Has a manager","example":true,"uniqueKey":"employee.and.items.[INDEX].hasManager.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"True selects employees with an assigned manager; false selects employees without a manager.","title":"Has a manager","example":true,"uniqueKey":"employee.and.items.[INDEX].hasManager.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.and.items.[INDEX].hasManager","typeLabel":"boolean | null"},"employeeGroupId":{"oneOf":[{"type":"string","minLength":1,"maxLength":128,"description":"Select employees belonging to this employee group.","title":"Employee group ID","example":"group-engineering","uniqueKey":"employee.and.items.[INDEX].employeeGroupId.oneOf.0","typeLabel":"string"},{"type":"null","minLength":1,"maxLength":128,"description":"Select employees belonging to this employee group.","title":"Employee group ID","example":"group-engineering","uniqueKey":"employee.and.items.[INDEX].employeeGroupId.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.and.items.[INDEX].employeeGroupId","typeLabel":"string | null"},"employeeGroupIds":{"oneOf":[{"type":"array","items":{"type":"string","minLength":1,"maxLength":128,"uniqueKey":"employee.and.items.[INDEX].employeeGroupIds.oneOf.0.items.[INDEX]","typeLabel":"string"},"maxItems":1000,"description":"Select members of any listed employee group. Up to 1000 IDs.","title":"Employee group IDs","example":["group-engineering"],"uniqueKey":"employee.and.items.[INDEX].employeeGroupIds.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":1000,"description":"Select members of any listed employee group. Up to 1000 IDs.","title":"Employee group IDs","example":["group-engineering"],"uniqueKey":"employee.and.items.[INDEX].employeeGroupIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.and.items.[INDEX].employeeGroupIds","typeLabel":"string[] | null"},"jobTitle":{"oneOf":[{"type":"string","maxLength":256,"description":"Select employees whose job title exactly matches this value.","title":"Exact job title","example":"Engineer","uniqueKey":"employee.and.items.[INDEX].jobTitle.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":256,"description":"Select employees whose job title exactly matches this value.","title":"Exact job title","example":"Engineer","uniqueKey":"employee.and.items.[INDEX].jobTitle.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.and.items.[INDEX].jobTitle","typeLabel":"string | null"},"jobTitles":{"oneOf":[{"type":"array","items":{"type":"string","maxLength":256,"uniqueKey":"employee.and.items.[INDEX].jobTitles.oneOf.0.items.[INDEX]","typeLabel":"string"},"maxItems":1000,"description":"Select employees whose job title exactly matches any listed value. Up to 1000 titles.","title":"Exact job titles","example":["Engineer","Designer"],"uniqueKey":"employee.and.items.[INDEX].jobTitles.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string","maxLength":256},"maxItems":1000,"description":"Select employees whose job title exactly matches any listed value. Up to 1000 titles.","title":"Exact job titles","example":["Engineer","Designer"],"uniqueKey":"employee.and.items.[INDEX].jobTitles.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.and.items.[INDEX].jobTitles","typeLabel":"string[] | null"},"countries":{"oneOf":[{"type":"array","items":{"type":"string","minLength":1,"maxLength":128,"uniqueKey":"employee.and.items.[INDEX].countries.oneOf.0.items.[INDEX]","typeLabel":"string"},"maxItems":1000,"description":"Select employees whose HRIS work country matches any listed country code. Up to 1000 values.","title":"Work countries","example":["US"],"uniqueKey":"employee.and.items.[INDEX].countries.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":1000,"description":"Select employees whose HRIS work country matches any listed country code. Up to 1000 values.","title":"Work countries","example":["US"],"uniqueKey":"employee.and.items.[INDEX].countries.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.and.items.[INDEX].countries","typeLabel":"string[] | null"},"emails":{"oneOf":[{"type":"array","items":{"type":"string","maxLength":320,"format":"email","uniqueKey":"employee.and.items.[INDEX].emails.oneOf.0.items.[INDEX]","typeLabel":"string\u003cemail>"},"maxItems":1000,"description":"Select employees associated with any listed email address. Up to 1000 valid addresses.","title":"Employee email addresses","example":["avery@example.test"],"uniqueKey":"employee.and.items.[INDEX].emails.oneOf.0","typeLabel":"string\u003cemail>[]"},{"type":"null","items":{"type":"string","maxLength":320,"format":"email"},"maxItems":1000,"description":"Select employees associated with any listed email address. Up to 1000 valid addresses.","title":"Employee email addresses","example":["avery@example.test"],"uniqueKey":"employee.and.items.[INDEX].emails.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.and.items.[INDEX].emails","typeLabel":"string\u003cemail>[] | null"},"emailDomains":{"oneOf":[{"type":"array","items":{"type":"string","maxLength":254,"uniqueKey":"employee.and.items.[INDEX].emailDomains.oneOf.0.items.[INDEX]","typeLabel":"string"},"maxItems":1000,"description":"Select employees with an email address on any listed domain. A domain matches exactly, so subdomains are listed separately. Up to 1000 values.","title":"Employee email domains","example":["example.test"],"uniqueKey":"employee.and.items.[INDEX].emailDomains.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string","maxLength":254},"maxItems":1000,"description":"Select employees with an email address on any listed domain. A domain matches exactly, so subdomains are listed separately. Up to 1000 values.","title":"Employee email domains","example":["example.test"],"uniqueKey":"employee.and.items.[INDEX].emailDomains.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.and.items.[INDEX].emailDomains","typeLabel":"string[] | null"},"employeeId":{"oneOf":[{"type":"string","minLength":1,"maxLength":128,"description":"Select a single employee by ID.","title":"Employee ID","example":"employee-avery","uniqueKey":"employee.and.items.[INDEX].employeeId.oneOf.0","typeLabel":"string"},{"type":"null","minLength":1,"maxLength":128,"description":"Select a single employee by ID.","title":"Employee ID","example":"employee-avery","uniqueKey":"employee.and.items.[INDEX].employeeId.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.and.items.[INDEX].employeeId","typeLabel":"string | null"},"employeeIds":{"oneOf":[{"type":"array","items":{"type":"string","minLength":1,"maxLength":128,"uniqueKey":"employee.and.items.[INDEX].employeeIds.oneOf.0.items.[INDEX]","typeLabel":"string"},"maxItems":1000,"description":"Select employees with any listed ID. Up to 1000 IDs.","title":"Employee IDs","example":["employee-avery"],"uniqueKey":"employee.and.items.[INDEX].employeeIds.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":1000,"description":"Select employees with any listed ID. Up to 1000 IDs.","title":"Employee IDs","example":["employee-avery"],"uniqueKey":"employee.and.items.[INDEX].employeeIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.and.items.[INDEX].employeeIds","typeLabel":"string[] | null"},"excludedEmployeeId":{"oneOf":[{"type":"string","minLength":1,"maxLength":128,"description":"Exclude this employee from the results.","title":"Excluded employee ID","example":"employee-excluded","uniqueKey":"employee.and.items.[INDEX].excludedEmployeeId.oneOf.0","typeLabel":"string"},{"type":"null","minLength":1,"maxLength":128,"description":"Exclude this employee from the results.","title":"Excluded employee ID","example":"employee-excluded","uniqueKey":"employee.and.items.[INDEX].excludedEmployeeId.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.and.items.[INDEX].excludedEmployeeId","typeLabel":"string | null"},"excludedEmployeeIds":{"oneOf":[{"type":"array","items":{"type":"string","minLength":1,"maxLength":128,"uniqueKey":"employee.and.items.[INDEX].excludedEmployeeIds.oneOf.0.items.[INDEX]","typeLabel":"string"},"maxItems":1000,"description":"Exclude employees with any listed ID. Use this field for exclusions in API bulk mutations. Up to 1000 IDs.","title":"Excluded employee IDs","example":["employee-excluded"],"uniqueKey":"employee.and.items.[INDEX].excludedEmployeeIds.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":1000,"description":"Exclude employees with any listed ID. Use this field for exclusions in API bulk mutations. Up to 1000 IDs.","title":"Excluded employee IDs","example":["employee-excluded"],"uniqueKey":"employee.and.items.[INDEX].excludedEmployeeIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.and.items.[INDEX].excludedEmployeeIds","typeLabel":"string[] | null"},"managerId":{"oneOf":[{"type":"string","minLength":1,"maxLength":128,"description":"Select direct reports of this manager; exclude deeper reports.","title":"Direct manager ID","example":"employee-morgan","uniqueKey":"employee.and.items.[INDEX].managerId.oneOf.0","typeLabel":"string"},{"type":"null","minLength":1,"maxLength":128,"description":"Select direct reports of this manager; exclude deeper reports.","title":"Direct manager ID","example":"employee-morgan","uniqueKey":"employee.and.items.[INDEX].managerId.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.and.items.[INDEX].managerId","typeLabel":"string | null"},"managerIds":{"oneOf":[{"type":"array","items":{"type":"string","minLength":1,"maxLength":128,"uniqueKey":"employee.and.items.[INDEX].managerIds.oneOf.0.items.[INDEX]","typeLabel":"string"},"maxItems":1000,"description":"Select direct reports of any listed manager, at depth 1. Up to 1000 manager IDs.","title":"Direct manager IDs","example":["employee-morgan"],"uniqueKey":"employee.and.items.[INDEX].managerIds.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":1000,"description":"Select direct reports of any listed manager, at depth 1. Up to 1000 manager IDs.","title":"Direct manager IDs","example":["employee-morgan"],"uniqueKey":"employee.and.items.[INDEX].managerIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.and.items.[INDEX].managerIds","typeLabel":"string[] | null"},"ancestorManagerId":{"oneOf":[{"type":"string","minLength":1,"maxLength":128,"description":"Select direct and indirect reports below this manager at any depth.","title":"Ancestor manager ID","example":"employee-morgan","uniqueKey":"employee.and.items.[INDEX].ancestorManagerId.oneOf.0","typeLabel":"string"},{"type":"null","minLength":1,"maxLength":128,"description":"Select direct and indirect reports below this manager at any depth.","title":"Ancestor manager ID","example":"employee-morgan","uniqueKey":"employee.and.items.[INDEX].ancestorManagerId.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.and.items.[INDEX].ancestorManagerId","typeLabel":"string | null"},"ancestorManagerIds":{"oneOf":[{"type":"array","items":{"type":"string","minLength":1,"maxLength":128,"uniqueKey":"employee.and.items.[INDEX].ancestorManagerIds.oneOf.0.items.[INDEX]","typeLabel":"string"},"maxItems":1000,"description":"Select anyone below any listed manager, at depth 1 or greater. Up to 1000 manager IDs.","title":"Ancestor manager IDs","example":["employee-morgan"],"uniqueKey":"employee.and.items.[INDEX].ancestorManagerIds.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":1000,"description":"Select anyone below any listed manager, at depth 1 or greater. Up to 1000 manager IDs.","title":"Ancestor manager IDs","example":["employee-morgan"],"uniqueKey":"employee.and.items.[INDEX].ancestorManagerIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.and.items.[INDEX].ancestorManagerIds","typeLabel":"string[] | null"},"indirectManagerId":{"oneOf":[{"type":"string","minLength":1,"maxLength":128,"description":"Select reports at depth 2 or greater below this manager; exclude direct reports.","title":"Indirect manager ID","example":"employee-morgan","uniqueKey":"employee.and.items.[INDEX].indirectManagerId.oneOf.0","typeLabel":"string"},{"type":"null","minLength":1,"maxLength":128,"description":"Select reports at depth 2 or greater below this manager; exclude direct reports.","title":"Indirect manager ID","example":"employee-morgan","uniqueKey":"employee.and.items.[INDEX].indirectManagerId.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.and.items.[INDEX].indirectManagerId","typeLabel":"string | null"},"indirectManagerIds":{"oneOf":[{"type":"array","items":{"type":"string","minLength":1,"maxLength":128,"uniqueKey":"employee.and.items.[INDEX].indirectManagerIds.oneOf.0.items.[INDEX]","typeLabel":"string"},"maxItems":1000,"description":"Select reports at depth 2 or greater below any listed manager. Up to 1000 manager IDs.","title":"Indirect manager IDs","example":["employee-morgan"],"uniqueKey":"employee.and.items.[INDEX].indirectManagerIds.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":1000,"description":"Select reports at depth 2 or greater below any listed manager. Up to 1000 manager IDs.","title":"Indirect manager IDs","example":["employee-morgan"],"uniqueKey":"employee.and.items.[INDEX].indirectManagerIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.and.items.[INDEX].indirectManagerIds","typeLabel":"string[] | null"},"isMember":{"oneOf":[{"type":"boolean","description":"True selects employees with active workspace membership; false selects employees without a member link or with inactive membership.","title":"Has active workspace membership","example":true,"uniqueKey":"employee.and.items.[INDEX].isMember.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"True selects employees with active workspace membership; false selects employees without a member link or with inactive membership.","title":"Has active workspace membership","example":true,"uniqueKey":"employee.and.items.[INDEX].isMember.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.and.items.[INDEX].isMember","typeLabel":"boolean | null"},"memberRole":{"oneOf":[{"type":"string","enum":["admin","hr-admin","integration-manager","data-analyst","team-member",null],"description":"Select employees associated with this workspace member role.","title":"Workspace role","example":"team-member","uniqueKey":"employee.and.items.[INDEX].memberRole.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["admin","hr-admin","integration-manager","data-analyst","team-member",null],"description":"Select employees associated with this workspace member role.","title":"Workspace role","example":"team-member","uniqueKey":"employee.and.items.[INDEX].memberRole.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.and.items.[INDEX].memberRole","typeLabel":"enum\u003cstring> | null"},"query":{"oneOf":[{"type":"string","maxLength":256,"description":"Search employee names, preferred names, and the part of each employee email before the @. Names also match close spellings. Job titles and email domains are not searched; use jobTitle to filter by title. A top-level query controls the default relevance ordering.","title":"Employee search text","example":"Avery","uniqueKey":"employee.and.items.[INDEX].query.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":256,"description":"Search employee names, preferred names, and the part of each employee email before the @. Names also match close spellings. Job titles and email domains are not searched; use jobTitle to filter by title. A top-level query controls the default relevance ordering.","title":"Employee search text","example":"Avery","uniqueKey":"employee.and.items.[INDEX].query.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.and.items.[INDEX].query","typeLabel":"string | null"},"platformAccess":{"oneOf":[{"type":"string","enum":["HAS_ACCESS","INVITE_PENDING","NO_ACCESS",null],"description":"HAS_ACCESS selects active access; INVITE_PENDING selects pending invitations; NO_ACCESS selects employees without access.","title":"Workspace access status","example":"HAS_ACCESS","uniqueKey":"employee.and.items.[INDEX].platformAccess.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["HAS_ACCESS","INVITE_PENDING","NO_ACCESS",null],"description":"HAS_ACCESS selects active access; INVITE_PENDING selects pending invitations; NO_ACCESS selects employees without access.","title":"Workspace access status","example":"HAS_ACCESS","uniqueKey":"employee.and.items.[INDEX].platformAccess.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.and.items.[INDEX].platformAccess","typeLabel":"enum\u003cstring> | null"},"startDate":{"oneOf":[{"type":"object","title":"Start-date range","description":"Select start dates within inclusive date bounds or a supported named date range.","required":["range"],"properties":{"range":{"type":"string","minLength":1,"maxLength":128,"isRequired":true,"uniqueKey":"employee.and.items.[INDEX].startDate.oneOf.0.range","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"employee.and.items.[INDEX].startDate.oneOf.0","typeLabel":"Start-date range · object"},{"type":"object","title":"Start-date range","description":"Select start dates within inclusive date bounds or a supported named date range.","example":{"from":"2025-01-01","to":"2025-12-31"},"properties":{"from":{"oneOf":[{"type":"string","description":"ISO 8601 date or datetime. Inclusive lower bound.","format":"date","uniqueKey":"employee.and.items.[INDEX].startDate.oneOf.1.from.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"string","description":"ISO 8601 date or datetime. Inclusive lower bound.","format":"date-time","uniqueKey":"employee.and.items.[INDEX].startDate.oneOf.1.from.oneOf.1","typeLabel":"string\u003cdate-time>"}],"uniqueKey":"employee.and.items.[INDEX].startDate.oneOf.1.from","typeLabel":"string\u003cdate> | string\u003cdate-time>"},"to":{"oneOf":[{"type":"string","description":"ISO 8601 date or datetime. Inclusive upper bound.","format":"date","uniqueKey":"employee.and.items.[INDEX].startDate.oneOf.1.to.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"string","description":"ISO 8601 date or datetime. Inclusive upper bound.","format":"date-time","uniqueKey":"employee.and.items.[INDEX].startDate.oneOf.1.to.oneOf.1","typeLabel":"string\u003cdate-time>"}],"uniqueKey":"employee.and.items.[INDEX].startDate.oneOf.1.to","typeLabel":"string\u003cdate> | string\u003cdate-time>"}},"additionalProperties":false,"uniqueKey":"employee.and.items.[INDEX].startDate.oneOf.1","typeLabel":"Start-date range · object"},{"type":"null","title":"Start-date range","description":"Select start dates within inclusive date bounds or a supported named date range.","example":{"from":"2025-01-01","to":"2025-12-31"},"uniqueKey":"employee.and.items.[INDEX].startDate.oneOf.2","typeLabel":"null"}],"uniqueKey":"employee.and.items.[INDEX].startDate","typeLabel":"Start-date range · object · Start-date range · object · null"},"isAccountAdmin":{"oneOf":[{"type":"boolean","description":"True selects account administrators; false selects employees who are not account administrators.","title":"Account administrator","example":false,"uniqueKey":"employee.and.items.[INDEX].isAccountAdmin.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"True selects account administrators; false selects employees who are not account administrators.","title":"Account administrator","example":false,"uniqueKey":"employee.and.items.[INDEX].isAccountAdmin.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.and.items.[INDEX].isAccountAdmin","typeLabel":"boolean | null"},"hasIntegrationIds":{"oneOf":[{"type":"array","items":{"type":"string","minLength":1,"maxLength":128,"uniqueKey":"employee.and.items.[INDEX].hasIntegrationIds.oneOf.0.items.[INDEX]","typeLabel":"string"},"maxItems":1000,"description":"Select employees linked to every listed integration identifier. Up to 1000 IDs.","title":"Linked integrations","example":["slack"],"uniqueKey":"employee.and.items.[INDEX].hasIntegrationIds.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":1000,"description":"Select employees linked to every listed integration identifier. Up to 1000 IDs.","title":"Linked integrations","example":["slack"],"uniqueKey":"employee.and.items.[INDEX].hasIntegrationIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.and.items.[INDEX].hasIntegrationIds","typeLabel":"string[] | null"},"lacksIntegrationIds":{"oneOf":[{"type":"array","items":{"type":"string","minLength":1,"maxLength":128,"uniqueKey":"employee.and.items.[INDEX].lacksIntegrationIds.oneOf.0.items.[INDEX]","typeLabel":"string"},"maxItems":1000,"description":"Select employees without links to the listed integration identifiers. Up to 1000 IDs.","title":"Unlinked integrations","example":["slack"],"uniqueKey":"employee.and.items.[INDEX].lacksIntegrationIds.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":1000,"description":"Select employees without links to the listed integration identifiers. Up to 1000 IDs.","title":"Unlinked integrations","example":["slack"],"uniqueKey":"employee.and.items.[INDEX].lacksIntegrationIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.and.items.[INDEX].lacksIntegrationIds","typeLabel":"string[] | null"},"status":{"type":"string","enum":["CURRENT","FORMER","ALL"],"default":"CURRENT","description":"CURRENT selects unarchived employees, FORMER selects archived employees, and ALL includes both. Defaults to CURRENT.","title":"Employment status","example":"CURRENT","uniqueKey":"employee.and.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"and":{"type":"array","items":{"$circularRef":"3f52a7b7-cd0b-4f67-8832-fb1426671640"},"maxItems":49,"description":"All child filters must match, in addition to the other predicates in this filter. Up to 49 children.","title":"All conditions","uniqueKey":"employee.and.items.[INDEX].and","typeLabel":"All conditions · array"},"or":{"type":"array","items":{"$circularRef":"3f52a7b7-cd0b-4f67-8832-fb1426671640"},"maxItems":49,"description":"At least one child filter must match, in addition to the other predicates in this filter. Up to 49 children.","title":"Any condition","uniqueKey":"employee.and.items.[INDEX].or","typeLabel":"Any condition · array"}},"additionalProperties":false,"uniqueKey":"employee.and.items.[INDEX]","typeLabel":"object"},"maxItems":49,"description":"All child filters must match, in addition to the other predicates in this filter. Up to 49 children.","title":"All conditions","uniqueKey":"employee.and","typeLabel":"All conditions · object[]"},"or":{"type":"array","items":{"type":"object","properties":{"hasDirectReports":{"oneOf":[{"type":"boolean","description":"True selects managers with a direct report; false selects employees without direct reports.","title":"Has direct reports","example":true,"uniqueKey":"employee.or.items.[INDEX].hasDirectReports.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"True selects managers with a direct report; false selects employees without direct reports.","title":"Has direct reports","example":true,"uniqueKey":"employee.or.items.[INDEX].hasDirectReports.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.or.items.[INDEX].hasDirectReports","typeLabel":"boolean | null"},"hasManager":{"oneOf":[{"type":"boolean","description":"True selects employees with an assigned manager; false selects employees without a manager.","title":"Has a manager","example":true,"uniqueKey":"employee.or.items.[INDEX].hasManager.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"True selects employees with an assigned manager; false selects employees without a manager.","title":"Has a manager","example":true,"uniqueKey":"employee.or.items.[INDEX].hasManager.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.or.items.[INDEX].hasManager","typeLabel":"boolean | null"},"employeeGroupId":{"oneOf":[{"type":"string","minLength":1,"maxLength":128,"description":"Select employees belonging to this employee group.","title":"Employee group ID","example":"group-engineering","uniqueKey":"employee.or.items.[INDEX].employeeGroupId.oneOf.0","typeLabel":"string"},{"type":"null","minLength":1,"maxLength":128,"description":"Select employees belonging to this employee group.","title":"Employee group ID","example":"group-engineering","uniqueKey":"employee.or.items.[INDEX].employeeGroupId.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.or.items.[INDEX].employeeGroupId","typeLabel":"string | null"},"employeeGroupIds":{"oneOf":[{"type":"array","items":{"type":"string","minLength":1,"maxLength":128,"uniqueKey":"employee.or.items.[INDEX].employeeGroupIds.oneOf.0.items.[INDEX]","typeLabel":"string"},"maxItems":1000,"description":"Select members of any listed employee group. Up to 1000 IDs.","title":"Employee group IDs","example":["group-engineering"],"uniqueKey":"employee.or.items.[INDEX].employeeGroupIds.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":1000,"description":"Select members of any listed employee group. Up to 1000 IDs.","title":"Employee group IDs","example":["group-engineering"],"uniqueKey":"employee.or.items.[INDEX].employeeGroupIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.or.items.[INDEX].employeeGroupIds","typeLabel":"string[] | null"},"jobTitle":{"oneOf":[{"type":"string","maxLength":256,"description":"Select employees whose job title exactly matches this value.","title":"Exact job title","example":"Engineer","uniqueKey":"employee.or.items.[INDEX].jobTitle.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":256,"description":"Select employees whose job title exactly matches this value.","title":"Exact job title","example":"Engineer","uniqueKey":"employee.or.items.[INDEX].jobTitle.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.or.items.[INDEX].jobTitle","typeLabel":"string | null"},"jobTitles":{"oneOf":[{"type":"array","items":{"type":"string","maxLength":256,"uniqueKey":"employee.or.items.[INDEX].jobTitles.oneOf.0.items.[INDEX]","typeLabel":"string"},"maxItems":1000,"description":"Select employees whose job title exactly matches any listed value. Up to 1000 titles.","title":"Exact job titles","example":["Engineer","Designer"],"uniqueKey":"employee.or.items.[INDEX].jobTitles.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string","maxLength":256},"maxItems":1000,"description":"Select employees whose job title exactly matches any listed value. Up to 1000 titles.","title":"Exact job titles","example":["Engineer","Designer"],"uniqueKey":"employee.or.items.[INDEX].jobTitles.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.or.items.[INDEX].jobTitles","typeLabel":"string[] | null"},"countries":{"oneOf":[{"type":"array","items":{"type":"string","minLength":1,"maxLength":128,"uniqueKey":"employee.or.items.[INDEX].countries.oneOf.0.items.[INDEX]","typeLabel":"string"},"maxItems":1000,"description":"Select employees whose HRIS work country matches any listed country code. Up to 1000 values.","title":"Work countries","example":["US"],"uniqueKey":"employee.or.items.[INDEX].countries.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":1000,"description":"Select employees whose HRIS work country matches any listed country code. Up to 1000 values.","title":"Work countries","example":["US"],"uniqueKey":"employee.or.items.[INDEX].countries.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.or.items.[INDEX].countries","typeLabel":"string[] | null"},"emails":{"oneOf":[{"type":"array","items":{"type":"string","maxLength":320,"format":"email","uniqueKey":"employee.or.items.[INDEX].emails.oneOf.0.items.[INDEX]","typeLabel":"string\u003cemail>"},"maxItems":1000,"description":"Select employees associated with any listed email address. Up to 1000 valid addresses.","title":"Employee email addresses","example":["avery@example.test"],"uniqueKey":"employee.or.items.[INDEX].emails.oneOf.0","typeLabel":"string\u003cemail>[]"},{"type":"null","items":{"type":"string","maxLength":320,"format":"email"},"maxItems":1000,"description":"Select employees associated with any listed email address. Up to 1000 valid addresses.","title":"Employee email addresses","example":["avery@example.test"],"uniqueKey":"employee.or.items.[INDEX].emails.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.or.items.[INDEX].emails","typeLabel":"string\u003cemail>[] | null"},"emailDomains":{"oneOf":[{"type":"array","items":{"type":"string","maxLength":254,"uniqueKey":"employee.or.items.[INDEX].emailDomains.oneOf.0.items.[INDEX]","typeLabel":"string"},"maxItems":1000,"description":"Select employees with an email address on any listed domain. A domain matches exactly, so subdomains are listed separately. Up to 1000 values.","title":"Employee email domains","example":["example.test"],"uniqueKey":"employee.or.items.[INDEX].emailDomains.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string","maxLength":254},"maxItems":1000,"description":"Select employees with an email address on any listed domain. A domain matches exactly, so subdomains are listed separately. Up to 1000 values.","title":"Employee email domains","example":["example.test"],"uniqueKey":"employee.or.items.[INDEX].emailDomains.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.or.items.[INDEX].emailDomains","typeLabel":"string[] | null"},"employeeId":{"oneOf":[{"type":"string","minLength":1,"maxLength":128,"description":"Select a single employee by ID.","title":"Employee ID","example":"employee-avery","uniqueKey":"employee.or.items.[INDEX].employeeId.oneOf.0","typeLabel":"string"},{"type":"null","minLength":1,"maxLength":128,"description":"Select a single employee by ID.","title":"Employee ID","example":"employee-avery","uniqueKey":"employee.or.items.[INDEX].employeeId.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.or.items.[INDEX].employeeId","typeLabel":"string | null"},"employeeIds":{"oneOf":[{"type":"array","items":{"type":"string","minLength":1,"maxLength":128,"uniqueKey":"employee.or.items.[INDEX].employeeIds.oneOf.0.items.[INDEX]","typeLabel":"string"},"maxItems":1000,"description":"Select employees with any listed ID. Up to 1000 IDs.","title":"Employee IDs","example":["employee-avery"],"uniqueKey":"employee.or.items.[INDEX].employeeIds.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":1000,"description":"Select employees with any listed ID. Up to 1000 IDs.","title":"Employee IDs","example":["employee-avery"],"uniqueKey":"employee.or.items.[INDEX].employeeIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.or.items.[INDEX].employeeIds","typeLabel":"string[] | null"},"excludedEmployeeId":{"oneOf":[{"type":"string","minLength":1,"maxLength":128,"description":"Exclude this employee from the results.","title":"Excluded employee ID","example":"employee-excluded","uniqueKey":"employee.or.items.[INDEX].excludedEmployeeId.oneOf.0","typeLabel":"string"},{"type":"null","minLength":1,"maxLength":128,"description":"Exclude this employee from the results.","title":"Excluded employee ID","example":"employee-excluded","uniqueKey":"employee.or.items.[INDEX].excludedEmployeeId.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.or.items.[INDEX].excludedEmployeeId","typeLabel":"string | null"},"excludedEmployeeIds":{"oneOf":[{"type":"array","items":{"type":"string","minLength":1,"maxLength":128,"uniqueKey":"employee.or.items.[INDEX].excludedEmployeeIds.oneOf.0.items.[INDEX]","typeLabel":"string"},"maxItems":1000,"description":"Exclude employees with any listed ID. Use this field for exclusions in API bulk mutations. Up to 1000 IDs.","title":"Excluded employee IDs","example":["employee-excluded"],"uniqueKey":"employee.or.items.[INDEX].excludedEmployeeIds.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":1000,"description":"Exclude employees with any listed ID. Use this field for exclusions in API bulk mutations. Up to 1000 IDs.","title":"Excluded employee IDs","example":["employee-excluded"],"uniqueKey":"employee.or.items.[INDEX].excludedEmployeeIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.or.items.[INDEX].excludedEmployeeIds","typeLabel":"string[] | null"},"managerId":{"oneOf":[{"type":"string","minLength":1,"maxLength":128,"description":"Select direct reports of this manager; exclude deeper reports.","title":"Direct manager ID","example":"employee-morgan","uniqueKey":"employee.or.items.[INDEX].managerId.oneOf.0","typeLabel":"string"},{"type":"null","minLength":1,"maxLength":128,"description":"Select direct reports of this manager; exclude deeper reports.","title":"Direct manager ID","example":"employee-morgan","uniqueKey":"employee.or.items.[INDEX].managerId.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.or.items.[INDEX].managerId","typeLabel":"string | null"},"managerIds":{"oneOf":[{"type":"array","items":{"type":"string","minLength":1,"maxLength":128,"uniqueKey":"employee.or.items.[INDEX].managerIds.oneOf.0.items.[INDEX]","typeLabel":"string"},"maxItems":1000,"description":"Select direct reports of any listed manager, at depth 1. Up to 1000 manager IDs.","title":"Direct manager IDs","example":["employee-morgan"],"uniqueKey":"employee.or.items.[INDEX].managerIds.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":1000,"description":"Select direct reports of any listed manager, at depth 1. Up to 1000 manager IDs.","title":"Direct manager IDs","example":["employee-morgan"],"uniqueKey":"employee.or.items.[INDEX].managerIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.or.items.[INDEX].managerIds","typeLabel":"string[] | null"},"ancestorManagerId":{"oneOf":[{"type":"string","minLength":1,"maxLength":128,"description":"Select direct and indirect reports below this manager at any depth.","title":"Ancestor manager ID","example":"employee-morgan","uniqueKey":"employee.or.items.[INDEX].ancestorManagerId.oneOf.0","typeLabel":"string"},{"type":"null","minLength":1,"maxLength":128,"description":"Select direct and indirect reports below this manager at any depth.","title":"Ancestor manager ID","example":"employee-morgan","uniqueKey":"employee.or.items.[INDEX].ancestorManagerId.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.or.items.[INDEX].ancestorManagerId","typeLabel":"string | null"},"ancestorManagerIds":{"oneOf":[{"type":"array","items":{"type":"string","minLength":1,"maxLength":128,"uniqueKey":"employee.or.items.[INDEX].ancestorManagerIds.oneOf.0.items.[INDEX]","typeLabel":"string"},"maxItems":1000,"description":"Select anyone below any listed manager, at depth 1 or greater. Up to 1000 manager IDs.","title":"Ancestor manager IDs","example":["employee-morgan"],"uniqueKey":"employee.or.items.[INDEX].ancestorManagerIds.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":1000,"description":"Select anyone below any listed manager, at depth 1 or greater. Up to 1000 manager IDs.","title":"Ancestor manager IDs","example":["employee-morgan"],"uniqueKey":"employee.or.items.[INDEX].ancestorManagerIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.or.items.[INDEX].ancestorManagerIds","typeLabel":"string[] | null"},"indirectManagerId":{"oneOf":[{"type":"string","minLength":1,"maxLength":128,"description":"Select reports at depth 2 or greater below this manager; exclude direct reports.","title":"Indirect manager ID","example":"employee-morgan","uniqueKey":"employee.or.items.[INDEX].indirectManagerId.oneOf.0","typeLabel":"string"},{"type":"null","minLength":1,"maxLength":128,"description":"Select reports at depth 2 or greater below this manager; exclude direct reports.","title":"Indirect manager ID","example":"employee-morgan","uniqueKey":"employee.or.items.[INDEX].indirectManagerId.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.or.items.[INDEX].indirectManagerId","typeLabel":"string | null"},"indirectManagerIds":{"oneOf":[{"type":"array","items":{"type":"string","minLength":1,"maxLength":128,"uniqueKey":"employee.or.items.[INDEX].indirectManagerIds.oneOf.0.items.[INDEX]","typeLabel":"string"},"maxItems":1000,"description":"Select reports at depth 2 or greater below any listed manager. Up to 1000 manager IDs.","title":"Indirect manager IDs","example":["employee-morgan"],"uniqueKey":"employee.or.items.[INDEX].indirectManagerIds.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":1000,"description":"Select reports at depth 2 or greater below any listed manager. Up to 1000 manager IDs.","title":"Indirect manager IDs","example":["employee-morgan"],"uniqueKey":"employee.or.items.[INDEX].indirectManagerIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.or.items.[INDEX].indirectManagerIds","typeLabel":"string[] | null"},"isMember":{"oneOf":[{"type":"boolean","description":"True selects employees with active workspace membership; false selects employees without a member link or with inactive membership.","title":"Has active workspace membership","example":true,"uniqueKey":"employee.or.items.[INDEX].isMember.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"True selects employees with active workspace membership; false selects employees without a member link or with inactive membership.","title":"Has active workspace membership","example":true,"uniqueKey":"employee.or.items.[INDEX].isMember.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.or.items.[INDEX].isMember","typeLabel":"boolean | null"},"memberRole":{"oneOf":[{"type":"string","enum":["admin","hr-admin","integration-manager","data-analyst","team-member",null],"description":"Select employees associated with this workspace member role.","title":"Workspace role","example":"team-member","uniqueKey":"employee.or.items.[INDEX].memberRole.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["admin","hr-admin","integration-manager","data-analyst","team-member",null],"description":"Select employees associated with this workspace member role.","title":"Workspace role","example":"team-member","uniqueKey":"employee.or.items.[INDEX].memberRole.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.or.items.[INDEX].memberRole","typeLabel":"enum\u003cstring> | null"},"query":{"oneOf":[{"type":"string","maxLength":256,"description":"Search employee names, preferred names, and the part of each employee email before the @. Names also match close spellings. Job titles and email domains are not searched; use jobTitle to filter by title. A top-level query controls the default relevance ordering.","title":"Employee search text","example":"Avery","uniqueKey":"employee.or.items.[INDEX].query.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":256,"description":"Search employee names, preferred names, and the part of each employee email before the @. Names also match close spellings. Job titles and email domains are not searched; use jobTitle to filter by title. A top-level query controls the default relevance ordering.","title":"Employee search text","example":"Avery","uniqueKey":"employee.or.items.[INDEX].query.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.or.items.[INDEX].query","typeLabel":"string | null"},"platformAccess":{"oneOf":[{"type":"string","enum":["HAS_ACCESS","INVITE_PENDING","NO_ACCESS",null],"description":"HAS_ACCESS selects active access; INVITE_PENDING selects pending invitations; NO_ACCESS selects employees without access.","title":"Workspace access status","example":"HAS_ACCESS","uniqueKey":"employee.or.items.[INDEX].platformAccess.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["HAS_ACCESS","INVITE_PENDING","NO_ACCESS",null],"description":"HAS_ACCESS selects active access; INVITE_PENDING selects pending invitations; NO_ACCESS selects employees without access.","title":"Workspace access status","example":"HAS_ACCESS","uniqueKey":"employee.or.items.[INDEX].platformAccess.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.or.items.[INDEX].platformAccess","typeLabel":"enum\u003cstring> | null"},"startDate":{"oneOf":[{"type":"object","title":"Start-date range","description":"Select start dates within inclusive date bounds or a supported named date range.","required":["range"],"properties":{"range":{"type":"string","minLength":1,"maxLength":128,"isRequired":true,"uniqueKey":"employee.or.items.[INDEX].startDate.oneOf.0.range","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"employee.or.items.[INDEX].startDate.oneOf.0","typeLabel":"Start-date range · object"},{"type":"object","title":"Start-date range","description":"Select start dates within inclusive date bounds or a supported named date range.","example":{"from":"2025-01-01","to":"2025-12-31"},"properties":{"from":{"oneOf":[{"type":"string","description":"ISO 8601 date or datetime. Inclusive lower bound.","format":"date","uniqueKey":"employee.or.items.[INDEX].startDate.oneOf.1.from.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"string","description":"ISO 8601 date or datetime. Inclusive lower bound.","format":"date-time","uniqueKey":"employee.or.items.[INDEX].startDate.oneOf.1.from.oneOf.1","typeLabel":"string\u003cdate-time>"}],"uniqueKey":"employee.or.items.[INDEX].startDate.oneOf.1.from","typeLabel":"string\u003cdate> | string\u003cdate-time>"},"to":{"oneOf":[{"type":"string","description":"ISO 8601 date or datetime. Inclusive upper bound.","format":"date","uniqueKey":"employee.or.items.[INDEX].startDate.oneOf.1.to.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"string","description":"ISO 8601 date or datetime. Inclusive upper bound.","format":"date-time","uniqueKey":"employee.or.items.[INDEX].startDate.oneOf.1.to.oneOf.1","typeLabel":"string\u003cdate-time>"}],"uniqueKey":"employee.or.items.[INDEX].startDate.oneOf.1.to","typeLabel":"string\u003cdate> | string\u003cdate-time>"}},"additionalProperties":false,"uniqueKey":"employee.or.items.[INDEX].startDate.oneOf.1","typeLabel":"Start-date range · object"},{"type":"null","title":"Start-date range","description":"Select start dates within inclusive date bounds or a supported named date range.","example":{"from":"2025-01-01","to":"2025-12-31"},"uniqueKey":"employee.or.items.[INDEX].startDate.oneOf.2","typeLabel":"null"}],"uniqueKey":"employee.or.items.[INDEX].startDate","typeLabel":"Start-date range · object · Start-date range · object · null"},"isAccountAdmin":{"oneOf":[{"type":"boolean","description":"True selects account administrators; false selects employees who are not account administrators.","title":"Account administrator","example":false,"uniqueKey":"employee.or.items.[INDEX].isAccountAdmin.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"True selects account administrators; false selects employees who are not account administrators.","title":"Account administrator","example":false,"uniqueKey":"employee.or.items.[INDEX].isAccountAdmin.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.or.items.[INDEX].isAccountAdmin","typeLabel":"boolean | null"},"hasIntegrationIds":{"oneOf":[{"type":"array","items":{"type":"string","minLength":1,"maxLength":128,"uniqueKey":"employee.or.items.[INDEX].hasIntegrationIds.oneOf.0.items.[INDEX]","typeLabel":"string"},"maxItems":1000,"description":"Select employees linked to every listed integration identifier. Up to 1000 IDs.","title":"Linked integrations","example":["slack"],"uniqueKey":"employee.or.items.[INDEX].hasIntegrationIds.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":1000,"description":"Select employees linked to every listed integration identifier. Up to 1000 IDs.","title":"Linked integrations","example":["slack"],"uniqueKey":"employee.or.items.[INDEX].hasIntegrationIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.or.items.[INDEX].hasIntegrationIds","typeLabel":"string[] | null"},"lacksIntegrationIds":{"oneOf":[{"type":"array","items":{"type":"string","minLength":1,"maxLength":128,"uniqueKey":"employee.or.items.[INDEX].lacksIntegrationIds.oneOf.0.items.[INDEX]","typeLabel":"string"},"maxItems":1000,"description":"Select employees without links to the listed integration identifiers. Up to 1000 IDs.","title":"Unlinked integrations","example":["slack"],"uniqueKey":"employee.or.items.[INDEX].lacksIntegrationIds.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":1000,"description":"Select employees without links to the listed integration identifiers. Up to 1000 IDs.","title":"Unlinked integrations","example":["slack"],"uniqueKey":"employee.or.items.[INDEX].lacksIntegrationIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"employee.or.items.[INDEX].lacksIntegrationIds","typeLabel":"string[] | null"},"status":{"type":"string","enum":["CURRENT","FORMER","ALL"],"default":"CURRENT","description":"CURRENT selects unarchived employees, FORMER selects archived employees, and ALL includes both. Defaults to CURRENT.","title":"Employment status","example":"CURRENT","uniqueKey":"employee.or.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"and":{"type":"array","items":{"$circularRef":"3f52a7b7-cd0b-4f67-8832-fb1426671640"},"maxItems":49,"description":"All child filters must match, in addition to the other predicates in this filter. Up to 49 children.","title":"All conditions","uniqueKey":"employee.or.items.[INDEX].and","typeLabel":"All conditions · array"},"or":{"type":"array","items":{"$circularRef":"3f52a7b7-cd0b-4f67-8832-fb1426671640"},"maxItems":49,"description":"At least one child filter must match, in addition to the other predicates in this filter. Up to 49 children.","title":"Any condition","uniqueKey":"employee.or.items.[INDEX].or","typeLabel":"Any condition · array"}},"additionalProperties":false,"uniqueKey":"employee.or.items.[INDEX]","typeLabel":"object"},"maxItems":49,"description":"At least one child filter must match, in addition to the other predicates in this filter. Up to 49 children.","title":"Any condition","uniqueKey":"employee.or","typeLabel":"Any condition · object[]"}},"additionalProperties":false,"uniqueKey":"employee","typeLabel":"Employees with stat data · object"}},"additionalProperties":false,"title":"Stat definition count request","example":{"valueTypes":["COUNT"],"includeDisabled":false},"uniqueKey":"","typeLabel":"Stat definition count request · object"},"examples":{"Example":{"title":"Example","value":{"valueTypes":["COUNT"],"includeDisabled":false}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"ef36dcfd-7ee0-44f4-b550-2f179d33c016":{"description":"Number of matching stat definitions","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer","minimum":0,"description":"Total matching items, independent of pagination. The route determines the item type.","title":"Total matches","example":1,"isRequired":true,"uniqueKey":"total","typeLabel":"integer"}},"required":["total"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"total":1}}},"exampleType":"generated"}},"exampleType":"generated"},"f7926080-c1ec-4790-88b1-385427e65837":{"description":"Bad request or request validation failed","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST"],"isRequired":true,"uniqueKey":"oneOf.0.error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.error.message","typeLabel":"string"},"requestId":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.error.requestId","typeLabel":"string"}},"required":["code","message","requestId"],"isRequired":true,"uniqueKey":"oneOf.0.error","typeLabel":"object"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","required":["error"],"properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_ERROR"],"isRequired":true,"uniqueKey":"oneOf.1.error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.error.message","typeLabel":"string"},"requestId":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.error.requestId","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"oneOf":[{"type":"string","uniqueKey":"oneOf.1.error.details.items.[INDEX].path.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"number","uniqueKey":"oneOf.1.error.details.items.[INDEX].path.items.[INDEX].oneOf.1","typeLabel":"number"}],"uniqueKey":"oneOf.1.error.details.items.[INDEX].path.items.[INDEX]","typeLabel":"string | number"},"isRequired":true,"uniqueKey":"oneOf.1.error.details.items.[INDEX].path","typeLabel":"(string | number)[]"},"message":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.error.details.items.[INDEX].message","typeLabel":"string"}},"required":["path","message"],"uniqueKey":"oneOf.1.error.details.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"oneOf.1.error.details","typeLabel":"object[]"}},"required":["code","message","requestId","details"],"isRequired":true,"uniqueKey":"oneOf.1.error","typeLabel":"object"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"BAD_REQUEST","message":"\u003cstring>","requestId":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"ea2a31de-7ab9-487b-a547-292d42b87e4c":{"description":"Authentication is missing or invalid. Send a valid API key or OAuth access token in the Authorization: Bearer \u003cTOKEN> header before retrying.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["UNAUTHORIZED"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"requestId":{"type":"string","isRequired":true,"uniqueKey":"error.requestId","typeLabel":"string"}},"required":["code","message","requestId"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"UNAUTHORIZED","message":"\u003cstring>","requestId":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"8753fb35-0e40-4d77-8348-b1f4194da743":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["FORBIDDEN"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"requestId":{"type":"string","isRequired":true,"uniqueKey":"error.requestId","typeLabel":"string"}},"required":["code","message","requestId"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"FORBIDDEN","message":"\u003cstring>","requestId":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"c954dbd0-a64e-4ab5-b759-c978722b5f4c":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["NOT_FOUND"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"requestId":{"type":"string","isRequired":true,"uniqueKey":"error.requestId","typeLabel":"string"}},"required":["code","message","requestId"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"NOT_FOUND","message":"\u003cstring>","requestId":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"6e6b63e9-e93d-4c6c-9639-edfd768962f6":{"description":"The API-client request budget is exhausted. API keys allow 500 requests per minute per key; OAuth clients allow 500 per minute per client and workspace. Reads and writes share the budget. One HTTP request counts once, including bulk requests. Wait for the Retry-After delay before retrying.","headers":{"Retry-After":{"description":"Number of seconds to wait before retrying the request.","required":true,"schema":{"type":"integer","minimum":0,"example":42}},"RateLimit":{"description":"Current request budget: limit is the maximum count, remaining is the unused count, and reset is seconds until the window resets, not a timestamp.","required":true,"schema":{"type":"string","example":"limit=500, remaining=0, reset=42"}},"RateLimit-Policy":{"description":"Request limit and window length in seconds, formatted as \u003climit>;w=\u003cseconds>.","required":true,"schema":{"type":"string","example":"500;w=60"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["RATE_LIMITED"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"requestId":{"type":"string","isRequired":true,"uniqueKey":"error.requestId","typeLabel":"string"}},"required":["code","message","requestId"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"RATE_LIMITED","message":"\u003cstring>","requestId":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"d3d68fbb-38f5-4070-a1b2-4e657046ea88":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Use an API key or OAuth access token. Enter only the token in the authorization dialog; requests send it as `Authorization: Bearer \u003cTOKEN>`.\n\nCreate an API key in your workspace's **Settings → API keys**. Keys start with `wm_api_` and only work in the workspace where they were created. Read-only keys can read data; creating, updating, or deleting data requires a read-write key.\n\n```http\nAuthorization: Bearer wm_api_example\n```\n\nOAuth access tokens are issued for connected Windmill applications.\n\n```http\nAuthorization: Bearer \u003cOAUTH_ACCESS_TOKEN>\n```\n\nBoth token types use the authenticated user's workspace permissions. Each endpoint's permission requirements and the sharing settings of the requested items still apply.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"c9e274ea-babc-40ce-84c8-2205f0a915c6":{"url":"https://api.gowindmill.com/api/v2"}},"schemas":{"3f52a7b7-cd0b-4f67-8832-fb1426671640":{"type":"object","properties":{"hasDirectReports":{"oneOf":[{"type":"boolean","title":"Has direct reports","description":"True selects managers with a direct report; false selects employees without direct reports.","example":true},{"type":"null","title":"Has direct reports","description":"True selects managers with a direct report; false selects employees without direct reports.","example":true}]},"hasManager":{"oneOf":[{"type":"boolean","title":"Has a manager","description":"True selects employees with an assigned manager; false selects employees without a manager.","example":true},{"type":"null","title":"Has a manager","description":"True selects employees with an assigned manager; false selects employees without a manager.","example":true}]},"employeeGroupId":{"oneOf":[{"type":"string","title":"Employee group ID","description":"Select employees belonging to this employee group.","maxLength":128,"minLength":1,"example":"group-engineering"},{"type":"null","title":"Employee group ID","description":"Select employees belonging to this employee group.","maxLength":128,"minLength":1,"example":"group-engineering"}]},"employeeGroupIds":{"oneOf":[{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"title":"Employee group IDs","description":"Select members of any listed employee group. Up to 1000 IDs.","maxItems":1000,"example":["group-engineering"]},{"type":"null","title":"Employee group IDs","description":"Select members of any listed employee group. Up to 1000 IDs.","maxItems":1000,"example":["group-engineering"]}]},"jobTitle":{"oneOf":[{"type":"string","title":"Exact job title","description":"Select employees whose job title exactly matches this value.","maxLength":256,"example":"Engineer"},{"type":"null","title":"Exact job title","description":"Select employees whose job title exactly matches this value.","maxLength":256,"example":"Engineer"}]},"jobTitles":{"oneOf":[{"type":"array","items":{"type":"string","maxLength":256},"title":"Exact job titles","description":"Select employees whose job title exactly matches any listed value. Up to 1000 titles.","maxItems":1000,"example":["Engineer","Designer"]},{"type":"null","title":"Exact job titles","description":"Select employees whose job title exactly matches any listed value. Up to 1000 titles.","maxItems":1000,"example":["Engineer","Designer"]}]},"countries":{"oneOf":[{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"title":"Work countries","description":"Select employees whose HRIS work country matches any listed country code. Up to 1000 values.","maxItems":1000,"example":["US"]},{"type":"null","title":"Work countries","description":"Select employees whose HRIS work country matches any listed country code. Up to 1000 values.","maxItems":1000,"example":["US"]}]},"emails":{"oneOf":[{"type":"array","items":{"type":"string","maxLength":320,"format":"email"},"title":"Employee email addresses","description":"Select employees associated with any listed email address. Up to 1000 valid addresses.","maxItems":1000,"example":["avery@example.test"]},{"type":"null","title":"Employee email addresses","description":"Select employees associated with any listed email address. Up to 1000 valid addresses.","maxItems":1000,"example":["avery@example.test"]}]},"emailDomains":{"oneOf":[{"type":"array","items":{"type":"string","maxLength":254},"title":"Employee email domains","description":"Select employees with an email address on any listed domain. A domain matches exactly, so subdomains are listed separately. Up to 1000 values.","maxItems":1000,"example":["example.test"]},{"type":"null","title":"Employee email domains","description":"Select employees with an email address on any listed domain. A domain matches exactly, so subdomains are listed separately. Up to 1000 values.","maxItems":1000,"example":["example.test"]}]},"employeeId":{"oneOf":[{"type":"string","title":"Employee ID","description":"Select a single employee by ID.","maxLength":128,"minLength":1,"example":"employee-avery"},{"type":"null","title":"Employee ID","description":"Select a single employee by ID.","maxLength":128,"minLength":1,"example":"employee-avery"}]},"employeeIds":{"oneOf":[{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"title":"Employee IDs","description":"Select employees with any listed ID. Up to 1000 IDs.","maxItems":1000,"example":["employee-avery"]},{"type":"null","title":"Employee IDs","description":"Select employees with any listed ID. Up to 1000 IDs.","maxItems":1000,"example":["employee-avery"]}]},"excludedEmployeeId":{"oneOf":[{"type":"string","title":"Excluded employee ID","description":"Exclude this employee from the results.","maxLength":128,"minLength":1,"example":"employee-excluded"},{"type":"null","title":"Excluded employee ID","description":"Exclude this employee from the results.","maxLength":128,"minLength":1,"example":"employee-excluded"}]},"excludedEmployeeIds":{"oneOf":[{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"title":"Excluded employee IDs","description":"Exclude employees with any listed ID. Use this field for exclusions in API bulk mutations. Up to 1000 IDs.","maxItems":1000,"example":["employee-excluded"]},{"type":"null","title":"Excluded employee IDs","description":"Exclude employees with any listed ID. Use this field for exclusions in API bulk mutations. Up to 1000 IDs.","maxItems":1000,"example":["employee-excluded"]}]},"managerId":{"oneOf":[{"type":"string","title":"Direct manager ID","description":"Select direct reports of this manager; exclude deeper reports.","maxLength":128,"minLength":1,"example":"employee-morgan"},{"type":"null","title":"Direct manager ID","description":"Select direct reports of this manager; exclude deeper reports.","maxLength":128,"minLength":1,"example":"employee-morgan"}]},"managerIds":{"oneOf":[{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"title":"Direct manager IDs","description":"Select direct reports of any listed manager, at depth 1. Up to 1000 manager IDs.","maxItems":1000,"example":["employee-morgan"]},{"type":"null","title":"Direct manager IDs","description":"Select direct reports of any listed manager, at depth 1. Up to 1000 manager IDs.","maxItems":1000,"example":["employee-morgan"]}]},"ancestorManagerId":{"oneOf":[{"type":"string","title":"Ancestor manager ID","description":"Select direct and indirect reports below this manager at any depth.","maxLength":128,"minLength":1,"example":"employee-morgan"},{"type":"null","title":"Ancestor manager ID","description":"Select direct and indirect reports below this manager at any depth.","maxLength":128,"minLength":1,"example":"employee-morgan"}]},"ancestorManagerIds":{"oneOf":[{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"title":"Ancestor manager IDs","description":"Select anyone below any listed manager, at depth 1 or greater. Up to 1000 manager IDs.","maxItems":1000,"example":["employee-morgan"]},{"type":"null","title":"Ancestor manager IDs","description":"Select anyone below any listed manager, at depth 1 or greater. Up to 1000 manager IDs.","maxItems":1000,"example":["employee-morgan"]}]},"indirectManagerId":{"oneOf":[{"type":"string","title":"Indirect manager ID","description":"Select reports at depth 2 or greater below this manager; exclude direct reports.","maxLength":128,"minLength":1,"example":"employee-morgan"},{"type":"null","title":"Indirect manager ID","description":"Select reports at depth 2 or greater below this manager; exclude direct reports.","maxLength":128,"minLength":1,"example":"employee-morgan"}]},"indirectManagerIds":{"oneOf":[{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"title":"Indirect manager IDs","description":"Select reports at depth 2 or greater below any listed manager. Up to 1000 manager IDs.","maxItems":1000,"example":["employee-morgan"]},{"type":"null","title":"Indirect manager IDs","description":"Select reports at depth 2 or greater below any listed manager. Up to 1000 manager IDs.","maxItems":1000,"example":["employee-morgan"]}]},"isMember":{"oneOf":[{"type":"boolean","title":"Has active workspace membership","description":"True selects employees with active workspace membership; false selects employees without a member link or with inactive membership.","example":true},{"type":"null","title":"Has active workspace membership","description":"True selects employees with active workspace membership; false selects employees without a member link or with inactive membership.","example":true}]},"memberRole":{"oneOf":[{"type":"string","title":"Workspace role","description":"Select employees associated with this workspace member role.","enum":["admin","hr-admin","integration-manager","data-analyst","team-member",null],"example":"team-member"},{"type":"null","title":"Workspace role","description":"Select employees associated with this workspace member role.","enum":["admin","hr-admin","integration-manager","data-analyst","team-member",null],"example":"team-member"}]},"query":{"oneOf":[{"type":"string","title":"Employee search text","description":"Search employee names, preferred names, and the part of each employee email before the @. Names also match close spellings. Job titles and email domains are not searched; use jobTitle to filter by title. A top-level query controls the default relevance ordering.","maxLength":256,"example":"Avery"},{"type":"null","title":"Employee search text","description":"Search employee names, preferred names, and the part of each employee email before the @. Names also match close spellings. Job titles and email domains are not searched; use jobTitle to filter by title. A top-level query controls the default relevance ordering.","maxLength":256,"example":"Avery"}]},"platformAccess":{"oneOf":[{"type":"string","title":"Workspace access status","description":"HAS_ACCESS selects active access; INVITE_PENDING selects pending invitations; NO_ACCESS selects employees without access.","enum":["HAS_ACCESS","INVITE_PENDING","NO_ACCESS",null],"example":"HAS_ACCESS"},{"type":"null","title":"Workspace access status","description":"HAS_ACCESS selects active access; INVITE_PENDING selects pending invitations; NO_ACCESS selects employees without access.","enum":["HAS_ACCESS","INVITE_PENDING","NO_ACCESS",null],"example":"HAS_ACCESS"}]},"startDate":{"oneOf":[{"type":"object","title":"Start-date range","description":"Select start dates within inclusive date bounds or a supported named date range.","required":["range"],"properties":{"range":{"type":"string","minLength":1,"maxLength":128,"isRequired":true}},"additionalProperties":false},{"type":"object","title":"Start-date range","description":"Select start dates within inclusive date bounds or a supported named date range.","example":{"from":"2025-01-01","to":"2025-12-31"},"properties":{"from":{"oneOf":[{"type":"string","description":"ISO 8601 date or datetime. Inclusive lower bound.","format":"date"},{"type":"string","description":"ISO 8601 date or datetime. Inclusive lower bound.","format":"date-time"}]},"to":{"oneOf":[{"type":"string","description":"ISO 8601 date or datetime. Inclusive upper bound.","format":"date"},{"type":"string","description":"ISO 8601 date or datetime. Inclusive upper bound.","format":"date-time"}]}},"additionalProperties":false},{"type":"null","title":"Start-date range","description":"Select start dates within inclusive date bounds or a supported named date range.","example":{"from":"2025-01-01","to":"2025-12-31"}}]},"isAccountAdmin":{"oneOf":[{"type":"boolean","title":"Account administrator","description":"True selects account administrators; false selects employees who are not account administrators.","example":false},{"type":"null","title":"Account administrator","description":"True selects account administrators; false selects employees who are not account administrators.","example":false}]},"hasIntegrationIds":{"oneOf":[{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"title":"Linked integrations","description":"Select employees linked to every listed integration identifier. Up to 1000 IDs.","maxItems":1000,"example":["slack"]},{"type":"null","title":"Linked integrations","description":"Select employees linked to every listed integration identifier. Up to 1000 IDs.","maxItems":1000,"example":["slack"]}]},"lacksIntegrationIds":{"oneOf":[{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"title":"Unlinked integrations","description":"Select employees without links to the listed integration identifiers. Up to 1000 IDs.","maxItems":1000,"example":["slack"]},{"type":"null","title":"Unlinked integrations","description":"Select employees without links to the listed integration identifiers. Up to 1000 IDs.","maxItems":1000,"example":["slack"]}]},"status":{"type":"string","enum":["CURRENT","FORMER","ALL"],"default":"CURRENT","description":"CURRENT selects unarchived employees, FORMER selects archived employees, and ALL includes both. Defaults to CURRENT.","title":"Employment status","example":"CURRENT"},"and":{"type":"array","items":{"$circularRef":"3f52a7b7-cd0b-4f67-8832-fb1426671640"},"maxItems":49,"description":"All child filters must match, in addition to the other predicates in this filter. Up to 49 children.","title":"All conditions"},"or":{"type":"array","items":{"$circularRef":"3f52a7b7-cd0b-4f67-8832-fb1426671640"},"maxItems":49,"description":"At least one child filter must match, in addition to the other predicates in this filter. Up to 49 children.","title":"Any condition"}},"additionalProperties":false}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Use an API key or OAuth access token. Enter only the token in the authorization dialog; requests send it as `Authorization: Bearer \u003cTOKEN>`.\n\nCreate an API key in your workspace's **Settings → API keys**. Keys start with `wm_api_` and only work in the workspace where they were created. Read-only keys can read data; creating, updating, or deleting data requires a read-write key.\n\n```http\nAuthorization: Bearer wm_api_example\n```\n\nOAuth access tokens are issued for connected Windmill applications.\n\n```http\nAuthorization: Bearer \u003cOAUTH_ACCESS_TOKEN>\n```\n\nBoth token types use the authenticated user's workspace permissions. Each endpoint's permission requirements and the sharing settings of the requested items still apply.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Use an API key or OAuth access token. Enter only the token in the authorization dialog; requests send it as `Authorization: Bearer \u003cTOKEN>`.\n\nCreate an API key in your workspace's **Settings → API keys**. Keys start with `wm_api_` and only work in the workspace where they were created. Read-only keys can read data; creating, updating, or deleting data requires a read-write key.\n\n```http\nAuthorization: Bearer wm_api_example\n```\n\nOAuth access tokens are issued for connected Windmill applications.\n\n```http\nAuthorization: Bearer \u003cOAUTH_ACCESS_TOKEN>\n```\n\nBoth token types use the authenticated user's workspace permissions. Each endpoint's permission requirements and the sharing settings of the requested items still apply.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"https://api.gowindmill.com/api/v2/openapi.json"},"subdomain":"windmill","siteName":"Windmill Help Site","title":"Count stat definitions - Windmill Help Site","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-20T16:42:54.617Z","originalFileLocation":"api-reference/stats/count-stat-definitions.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Counts definitions using the same filters, disabled-definition default, archived exclusion, and employee analytics access rules as the stat definition search. Counts each definition once, regardless of how many employees or stat rows match. Pagination does not affect the count.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Windmill Help Site\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/windmill/W7N_zh2zYbm8zD54/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/windmill/W7N_zh2zYbm8zD54/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/windmill/W7N_zh2zYbm8zD54/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/windmill/W7N_zh2zYbm8zD54/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/windmill/W7N_zh2zYbm8zD54/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/windmill/W7N_zh2zYbm8zD54/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/windmill/W7N_zh2zYbm8zD54/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/windmill/W7N_zh2zYbm8zD54/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/windmill/W7N_zh2zYbm8zD54/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Count stat definitions - Windmill Help Site\">\u003cmeta data-mint-head property=\"og:description\" content=\"Counts definitions using the same filters, disabled-definition default, archived exclusion, and employee analytics access rules as the stat definition search. Counts each definition once, regardless of how many employees or stat rows match. Pagination does not affect the count.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Windmill Help Center\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://help.gowindmill.com/api-reference/stats/count-stat-definitions\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://windmill.mintlify.site/_mintlify/api/og/v2?division=Stats\u0026amp;title=Count+stat+definitions\u0026amp;description=Counts+definitions+using+the+same+filters%2C+disabled-definition+default%2C+archived+exclusion%2C+and+employee+analytics+access+rules+as+the+stat+definition+search.+C\u0026amp;theme=819f4f407f94f51efe0e1a0f\u0026amp;signature=74f167d121c3f0da6b31f5f4a36b4096cf6d32463dae987aa23f877049a407cb\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Count stat definitions - Windmill Help Site\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Counts definitions using the same filters, disabled-definition default, archived exclusion, and employee analytics access rules as the stat definition search. Counts each definition once, regardless of how many employees or stat rows match. Pagination does not affect the count.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://windmill.mintlify.site/_mintlify/api/og/v2?division=Stats\u0026amp;title=Count+stat+definitions\u0026amp;description=Counts+definitions+using+the+same+filters%2C+disabled-definition+default%2C+archived+exclusion%2C+and+employee+analytics+access+rules+as+the+stat+definition+search.+C\u0026amp;theme=819f4f407f94f51efe0e1a0f\u0026amp;signature=74f167d121c3f0da6b31f5f4a36b4096cf6d32463dae987aa23f877049a407cb\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/windmill/W7N_zh2zYbm8zD54/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Windmill Help Site\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4084FB\">\u003clink data-mint-head rel=\"canonical\" href=\"https://help.gowindmill.com/api-reference/stats/count-stat-definitions\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/stats/count-stat-definitions.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://help.gowindmill.com/#organization\",\"name\":\"Windmill Help Site\",\"url\":\"https://help.gowindmill.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/windmill/438SkEPmWnjrcDyT/logo/light.svg?fit=max\u0026auto=format\u0026n=438SkEPmWnjrcDyT\u0026q=85\u0026s=911e75d2985851400d148f9e5e20c94f\"}},{\"@type\":\"WebSite\",\"@id\":\"https://help.gowindmill.com#website\",\"name\":\"Windmill Help Site\",\"url\":\"https://help.gowindmill.com\",\"publisher\":{\"@id\":\"https://help.gowindmill.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://help.gowindmill.com/api-reference/stats/count-stat-definitions#webpage\",\"url\":\"https://help.gowindmill.com/api-reference/stats/count-stat-definitions\",\"name\":\"Count stat definitions\",\"description\":\"Counts definitions using the same filters, disabled-definition default, archived exclusion, and employee analytics access rules as the stat definition search. Counts each definition once, regardless of how many employees or stat rows match. Pagination does not affect the count.\",\"dateModified\":\"2026-11-20T16:42:54.617Z\",\"isPartOf\":{\"@id\":\"https://help.gowindmill.com#website\"},\"breadcrumb\":{\"@id\":\"https://help.gowindmill.com/api-reference/stats/count-stat-definitions#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://help.gowindmill.com/api-reference/stats/count-stat-definitions#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://help.gowindmill.com/api-reference/tokens/get-token-information\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Stats\",\"item\":\"https://help.gowindmill.com/api-reference/stat-views/list-stat-views\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Count stat definitions\",\"item\":\"https://help.gowindmill.com/api-reference/stats/count-stat-definitions\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://help.gowindmill.com/api-reference/stats/count-stat-definitions#apireference\",\"headline\":\"Count stat definitions\",\"name\":\"Count stat definitions\",\"description\":\"Counts definitions using the same filters, disabled-definition default, archived exclusion, and employee analytics access rules as the stat definition search. Counts each definition once, regardless of how many employees or stat rows match. Pagination does not affect the count.\",\"url\":\"https://help.gowindmill.com/api-reference/stats/count-stat-definitions\",\"mainEntityOfPage\":{\"@id\":\"https://help.gowindmill.com/api-reference/stats/count-stat-definitions#webpage\"},\"dateModified\":\"2026-11-20T16:42:54.617Z\",\"publisher\":{\"@id\":\"https://help.gowindmill.com/#organization\"},\"isPartOf\":{\"@id\":\"https://help.gowindmill.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Windmill Help Site\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Windmill Help Site\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/stats/count-stat-definitions.md","siteName":"Windmill Help Site","nav":{"global":null,"tabs":[{"tab":"Platform","pages":[{"title":"Platform","href":""}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations/integrations"}]},{"tab":"API reference","groups":[{"group":"Getting started","icon":"code","pages":[{"title":"API overview","href":"/api-reference/overview"},{"title":"Authentication","href":"/api-reference/authentication"},{"title":"OAuth","href":"/api-reference/oauth"},{"title":"Making requests","href":"/api-reference/making-requests"},{"title":"Errors","href":"/api-reference/errors"},{"title":"Pagination","href":"/api-reference/pagination"},{"title":"Rate limits","href":"/api-reference/rate-limits"},{"title":"Versioning","href":"/api-reference/versioning"},{"title":"API changelog","href":"/api-reference/changelog"}]},{"group":"Endpoints","icon":"plug","pages":[{"group":"Tokens","pages":[{"title":"Get token information","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json get /token-info","href":"/api-reference/tokens/get-token-information"}]},{"group":"Employees","pages":[{"group":"Field sources","pages":[{"title":"List available employee field sources","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json get /c/{companyId}/field-sources/available-sources","href":"/api-reference/employee-field-sources/list-available-employee-field-sources"},{"title":"List company employee field defaults","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json get /c/{companyId}/field-sources/defaults","href":"/api-reference/employee-field-sources/list-company-employee-field-defaults"},{"title":"List employee field source overrides","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json get /c/{companyId}/employees/{employeeId}/field-sources","href":"/api-reference/employee-field-sources/list-employee-field-source-overrides"},{"title":"Resolve effective employee field sources","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json post /c/{companyId}/field-sources/resolve","href":"/api-reference/employee-field-sources/resolve-effective-employee-field-sources"},{"title":"Set a company employee field source","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json put /c/{companyId}/field-sources/defaults/{fieldKey}","href":"/api-reference/employee-field-sources/set-a-company-employee-field-source"},{"title":"Set an employee field source override","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json put /c/{companyId}/employees/{employeeId}/field-sources/{fieldKey}","href":"/api-reference/employee-field-sources/set-an-employee-field-source-override"},{"title":"Remove an employee field source override","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json delete /c/{companyId}/employees/{employeeId}/field-sources/{fieldKey}","href":"/api-reference/employee-field-sources/remove-an-employee-field-source-override"},{"title":"Remove a company employee field default","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json delete /c/{companyId}/field-sources/defaults/{fieldKey}","href":"/api-reference/employee-field-sources/remove-a-company-employee-field-default"}]},{"title":"Search employee profiles","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json post /c/{companyId}/employees/search","href":"/api-reference/employees/search-employee-profiles"},{"title":"Get an employee profile","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json get /c/{companyId}/employees/{employeeId}","href":"/api-reference/employees/get-an-employee-profile"},{"title":"Search employee IDs","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json post /c/{companyId}/employees/search/ids","href":"/api-reference/employees/search-employee-ids"},{"title":"Count matching employees","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json post /c/{companyId}/employees/count","href":"/api-reference/employees/count-matching-employees"},{"title":"Create an employee","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json post /c/{companyId}/employees","href":"/api-reference/employees/create-an-employee"},{"title":"Update an employee profile","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json patch /c/{companyId}/employees/{employeeId}","href":"/api-reference/employees/update-an-employee-profile"},{"title":"Set an employee's employment status","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json put /c/{companyId}/employees/{employeeId}/employment-status","href":"/api-reference/employees/set-an-employees-employment-status"},{"title":"Create employees in bulk","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json post /c/{companyId}/employees/bulk","href":"/api-reference/employees/create-employees-in-bulk"}]},{"group":"Groups","pages":[{"group":"Categories","pages":[{"title":"List employee group categories","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json get /c/{companyId}/groups/categories","href":"/api-reference/group-categories/list-employee-group-categories"},{"title":"Get an employee group category","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json get /c/{companyId}/groups/categories/{categoryId}","href":"/api-reference/group-categories/get-an-employee-group-category"},{"title":"Create an employee group category","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json post /c/{companyId}/groups/categories","href":"/api-reference/group-categories/create-an-employee-group-category"},{"title":"Update an employee group category","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json patch /c/{companyId}/groups/categories/{categoryId}","href":"/api-reference/group-categories/update-an-employee-group-category"},{"title":"Add employee groups to a category","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json post /c/{companyId}/groups/categories/{categoryId}/groups","href":"/api-reference/group-categories/add-employee-groups-to-a-category"},{"title":"Remove employee groups from a category","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json post /c/{companyId}/groups/categories/{categoryId}/groups/remove","href":"/api-reference/group-categories/remove-employee-groups-from-a-category"},{"title":"Delete an employee group category","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json delete /c/{companyId}/groups/categories/{categoryId}","href":"/api-reference/group-categories/delete-an-employee-group-category"}]},{"title":"List readable employee groups","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json get /c/{companyId}/groups","href":"/api-reference/groups/list-readable-employee-groups"},{"title":"Count readable employee groups","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json get /c/{companyId}/groups/count","href":"/api-reference/groups/count-readable-employee-groups"},{"title":"Get an employee group","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json get /c/{companyId}/groups/{groupId}","href":"/api-reference/groups/get-an-employee-group"},{"title":"Create an employee group","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json post /c/{companyId}/groups","href":"/api-reference/groups/create-an-employee-group"},{"title":"Update an employee group","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json patch /c/{companyId}/groups/{groupId}","href":"/api-reference/groups/update-an-employee-group"},{"title":"List employees in a group","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json get /c/{companyId}/groups/{groupId}/members","href":"/api-reference/groups/list-employees-in-a-group"},{"title":"Count employee group members","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json get /c/{companyId}/groups/{groupId}/members/count","href":"/api-reference/groups/count-employee-group-members"},{"title":"Add employees to a manual group","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json post /c/{companyId}/groups/{groupId}/members","href":"/api-reference/groups/add-employees-to-a-manual-group"},{"title":"Remove employees from a manual group","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json post /c/{companyId}/groups/{groupId}/members/remove","href":"/api-reference/groups/remove-employees-from-a-manual-group"},{"title":"Replace smart group employee rules","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json put /c/{companyId}/groups/{groupId}/rules","href":"/api-reference/groups/replace-smart-group-employee-rules"},{"title":"Refresh an employee group","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json post /c/{companyId}/groups/{groupId}/sync","href":"/api-reference/groups/refresh-an-employee-group"},{"title":"Replace employee group sharing","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json put /c/{companyId}/groups/{groupId}/access","href":"/api-reference/groups/replace-employee-group-sharing"},{"title":"Upload and review a group member CSV","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json post /c/{companyId}/groups/{groupId}/members/imports/uploads","href":"/api-reference/groups/upload-and-review-a-group-member-csv"},{"title":"Submit a reviewed group member import","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json post /c/{companyId}/groups/{groupId}/members/imports","href":"/api-reference/groups/submit-a-reviewed-group-member-import"},{"title":"Get group member import progress","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json get /c/{companyId}/groups/{groupId}/members/imports/{importId}","href":"/api-reference/groups/get-group-member-import-progress"},{"title":"Delete an employee group","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json delete /c/{companyId}/groups/{groupId}","href":"/api-reference/groups/delete-an-employee-group"}]},{"group":"Stats","pages":[{"group":"Views","pages":[{"title":"List stat views","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json get /c/{companyId}/stats/views","href":"/api-reference/stat-views/list-stat-views"},{"title":"Count stat views","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json get /c/{companyId}/stats/views/count","href":"/api-reference/stat-views/count-stat-views"},{"title":"Get a stat view","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json get /c/{companyId}/stats/views/{id}","href":"/api-reference/stat-views/get-a-stat-view"},{"title":"Create a stat view","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json post /c/{companyId}/stats/views","href":"/api-reference/stat-views/create-a-stat-view"},{"title":"Update a stat view","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json patch /c/{companyId}/stats/views/{id}","href":"/api-reference/stat-views/update-a-stat-view"},{"title":"Set stat view access","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json put /c/{companyId}/stats/views/{id}/access","href":"/api-reference/stat-views/set-stat-view-access"},{"title":"Delete a stat view","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json delete /c/{companyId}/stats/views/{id}","href":"/api-reference/stat-views/delete-a-stat-view"}]},{"title":"Search stat definitions","description":"Finds non-archived global and workspace stat definitions by definition ID, stat identifier, value type, literal text, or ownership. Disabled definitions are excluded unless includeDisabled is true. All supplied filters must match; within a list, matching any value is enough. With employee supplied, only definitions with recorded stat values for matching employees are returned. Any recorded date qualifies, including values of zero. Viewing stats for all employees requires workspace-wide analytics access. Other callers can read their own stats and those of their direct and indirect reports, plus employees covered by delegated reporting access. Employee filters only narrow that access. Omit employee to discover definitions even when no values have been recorded. Results use page/pageSize pagination, default 1/20 with a maximum page size of 100. Sorting defaults to label ascending with an ID tie-breaker. Set include.total to request the matching count. Any authenticated workspace member can search definitions.","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json post /c/{companyId}/stats/metadata/search","href":"/api-reference/stats/search-stat-definitions"},{"title":"Count stat definitions","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json post /c/{companyId}/stats/metadata/count","href":"/api-reference/stats/count-stat-definitions"},{"title":"Search employee stat series","description":"Returns employee stat series and range totals for a date range, keyed by employee ID. Discover definitions with POST /c/{companyId}/stats/metadata/search. Omit both statTypes and statMetadataIds to select all non-archived definitions; when both are supplied, a definition must match both. Employees and periods with no recorded data are omitted. Set include.data to false for range totals without period buckets. This response is not paginated. Viewing stats for all employees requires workspace-wide analytics access. Other callers can read their own stats and those of their direct and indirect reports, plus employees covered by delegated reporting access. Employee filters only narrow that access.","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json post /c/{companyId}/stats/search","href":"/api-reference/stats/search-employee-stat-series"},{"title":"Search employee stat totals","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json post /c/{companyId}/stats/employees/search","href":"/api-reference/stats/search-employee-stat-totals"},{"title":"Count employees matching stat totals","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json post /c/{companyId}/stats/employees/count","href":"/api-reference/stats/count-employees-matching-stat-totals"},{"title":"Export employee stats as CSV","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json post /c/{companyId}/stats/export/csv","href":"/api-reference/stats/export-employee-stats-as-csv"},{"title":"Create or replace a custom stat definition","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json put /c/{companyId}/stats/metadata","href":"/api-reference/stats/create-or-replace-a-custom-stat-definition"},{"title":"Upload custom employee stat values","deprecated":null,"version":null,"openapi":"https://api.gowindmill.com/api/v2/openapi.json put /c/{companyId}/stats/values","href":"/api-reference/stats/upload-custom-employee-stat-values"}]}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]},{"tab":"Best practices","pages":[{"title":"Best practices","href":"/introducing-windmill"}]}]},"basePath":"","title":"Count stat definitions - Windmill Help Site","deploymentId":"dpl_2pTxFtyBudBMYZiCw1MyvoA1wxpd","buildId":"dpl_2pTxFtyBudBMYZiCw1MyvoA1wxpd","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BtG4DSkw.js","snippetPresets-C1k1xDhp.js","utils-PMJoEt4Y.js","style-to-object-BY3JEAdk.js","utils-DW3Pr7Jq.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DIISLO2w.js","conditional-requirements-CFM0id0Q.js","cloneDeep-BErNCZCm.js","_Uint8Array-f0PCu9f_.js","isObject-FP1Yky1u.js","ApiExamples-OjY-8mqu.js","usePlaygroundInputsStore-B2HS2hUb.js","shallow-DVFuuIDQ.js","isEqual-DG0UKiQC.js","CodeSnippets-Cy6FBgwN.js","CodeSnippet-D1PtG8ed.js","getApiPlaygroundDisplay-Dkx2eNtL.js","Page-C8Cg25if.js","DynamicMarkdown-BvJIe00T.js","SectionHeading-B0rKYV8d.js","icon-yclzBff4.js","MethodPill-DxA11cCF.js","getPastedJson-CpkIDpMk.js","DuplicateIcon-CFCQNJ-D.js","axios-CsQoIw0U.js","Markdown-CK5C-fmV.js","AssistantPageLink-Cw134Dd-.js","dist-3xM3Qrc7.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}