Lists non-archived employees in a group that you can read, whether or not they have workspace access. Access to this list comes from the group; individual employee profile visibility does not further limit it. Supports employee-name search. Pages start at 1; pageSize defaults to 50 and is limited to 100. Request include.total for the matching count. Continue while pagination.hasMore is true. The default name order is last name, first name, then employee ID. Other sorts use the selected field, then employee ID. Missing, archived, or inaccessible groups return 404.
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"
groupId
string
required
Opaque employee group identifier in this company.
Example:
"group-engineering"
Query Parameters
query
string
Employee-name search using the same matching as the group member list.
Example:
"Avery"
page
integer
default:1
One-based page number. Defaults to 1.
Required range: 1 <= x <= 90071992547409
Example:
1
pageSize
integer
default:50
Maximum results per page, from 1 to 100. Defaults to 50.
Required range: 1 <= x <= 100
Example:
50
include
Additional response details · object
Request total:true to include pagination.total; otherwise no count is performed.
Show child attributes
Example:
{ "total": true }
sortProperty
enum<string>
default:name
Field used to order results. Supported values depend on this listing. Defaults to name.
Available options:
name,
email,
jobTitle,
id
Example:
"name"
sortDirection
enum<string>
default:asc
Ascending or descending order. Defaults to asc.
Available options:
asc,
desc
Example:
"asc"
Response
List group members.
Current non-archived roster page and optional matching count.
members
Group employee · object[]
required
Matching non-archived employees in the group. They need not have workspace membership.
{"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":"6aff06a676e1397cafb01751","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"Platform","count":143},{"language":"default","tag":"Review Cycles","count":50},{"language":"default","tag":"API reference","count":48},{"language":"default","tag":"Integrations","count":44},{"language":"default","tag":"Endpoints","count":39},{"language":"default","tag":"Productivity","count":30},{"language":"default","tag":"Pulse surveys","count":28},{"language":"default","tag":"Features","count":17},{"language":"default","tag":"Getting started","count":16},{"language":"default","tag":"Groups","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":"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":"control","enabled":true,"payload":{"type":"string","value":"control"},"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/groups/list-employees-in-a-group","slug":"/api-reference/groups/list-employees-in-a-group","pageMetadata":{"title":"List employees in a group","description":"Lists non-archived employees in a group that you can read, whether or not they have workspace access. Access to this list comes from the group; individual employee profile visibility does not further limit it. Supports employee-name search. Pages start at 1; pageSize defaults to 50 and is limited to 100. Request include.total for the matching count. Continue while pagination.hasMore is true. The default name order is last name, first name, then employee ID. Other sorts use the selected field, then employee ID. Missing, archived, or inaccessible groups return 404.","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","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: \"Lists non-archived employees in a group that you can read, whether or not they have workspace access. Access to this list comes from the group; individual employee profile visibility does not further limit it. Supports employee-name search. Pages start at 1; pageSize defaults to 50 and is limited to 100. Request include.total for the matching count. Continue while pagination.hasMore is true. The default name order is last name, first name, then employee ID. Other sorts use the selected field, then employee ID. Missing, archived, or inaccessible groups return 404.\"\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":"List employees in a group","description":"Lists non-archived employees in a group that you can read, whether or not they have workspace access. Access to this list comes from the group; individual employee profile visibility does not further limit it. Supports employee-name search. Pages start at 1; pageSize defaults to 50 and is limited to 100. Request include.total for the matching count. Continue while pagination.hasMore is true. The default name order is last name, first name, then employee ID. Other sorts use the selected field, then employee ID. Missing, archived, or inaccessible groups return 404.","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","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"groups.members.list","summary":"List employees in a group","description":"Lists non-archived employees in a group that you can read, whether or not they have workspace access. Access to this list comes from the group; individual employee profile visibility does not further limit it. Supports employee-name search. Pages start at 1; pageSize defaults to 50 and is limited to 100. Request include.total for the matching count. Continue while pagination.hasMore is true. The default name order is last name, first name, then employee ID. Other sorts use the selected field, then employee ID. Missing, archived, or inaccessible groups return 404.","tags":["Groups"],"security":["c6f5a23d-d0fd-4c90-be5c-5f93030c5f44"],"parameters":["f87cfccd-c49d-4cd7-8a4a-644b20ba1181","ec48bcba-d33c-4115-b761-6a7bd64c5625","8e59a1b4-9cb2-4832-910b-3247bccfa092","34e404cf-2ef9-4970-a157-94d4d7330ea3","357ac543-fccb-4fb3-b664-0676dce94445","dc482853-681d-4cca-9a62-e3ee5889860e","82194b2a-f3d9-4f23-965a-b3001fac97c0","097f44ac-095b-4308-9706-f07a213e4d5d"],"responses":{"200":"785ec30c-ec3b-425b-829e-ffd49dea2114","400":"d47d59a6-7d51-4800-bdbd-ddfc9104fab4","401":"ef749465-9081-4d5f-8e81-a1add54b7d02","403":"b38463b5-45ad-4010-bcdf-22ea82808188","404":"8f155b09-1796-48a1-bc47-0a07f433a7c8","429":"ca8fa597-1970-4629-9f48-6c2d82d55e25"},"method":"get","type":"path","servers":["bc3cc9da-1158-4cfa-97b3-e455483a1d98"],"path":"/c/{companyId}/groups/{groupId}/members","baseUrlOptions":["https://api.gowindmill.com/api/v2"],"title":"List employees in a group","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"f87cfccd-c49d-4cd7-8a4a-644b20ba1181":{"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"},"ec48bcba-d33c-4115-b761-6a7bd64c5625":{"schema":{"type":"string","description":"Opaque employee group identifier in this company.","title":"Employee group ID","example":"group-engineering","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true,"description":"Opaque employee group identifier in this company.","name":"groupId","in":"path"},"8e59a1b4-9cb2-4832-910b-3247bccfa092":{"schema":{"type":"string","description":"Employee-name search using the same matching as the group member list.","title":"Search text","example":"Avery","isRequired":false,"uniqueKey":"","typeLabel":"string"},"required":false,"description":"Employee-name search using the same matching as the group member list.","name":"query","in":"query"},"34e404cf-2ef9-4970-a157-94d4d7330ea3":{"schema":{"type":"integer","minimum":1,"maximum":90071992547409,"default":1,"description":"One-based page number. Defaults to 1.","title":"Page number","example":1,"isRequired":false,"uniqueKey":"","typeLabel":"integer"},"required":false,"description":"One-based page number. Defaults to 1.","name":"page","in":"query"},"357ac543-fccb-4fb3-b664-0676dce94445":{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"Maximum results per page, from 1 to 100. Defaults to 50.","title":"Page size","example":50,"isRequired":false,"uniqueKey":"","typeLabel":"integer"},"required":false,"description":"Maximum results per page, from 1 to 100. Defaults to 50.","name":"pageSize","in":"query"},"dc482853-681d-4cca-9a62-e3ee5889860e":{"schema":{"type":"object","properties":{"total":{"type":"boolean","description":"Set true to count all matching items and include pagination.total. False or omission skips the count.","title":"Include total count","example":true,"uniqueKey":"total","typeLabel":"boolean"}},"description":"Request total:true to include pagination.total; otherwise no count is performed.","title":"Additional response details","example":{"total":true},"isRequired":false,"uniqueKey":"","typeLabel":"Additional response details · object"},"required":false,"description":"Request total:true to include pagination.total; otherwise no count is performed.","style":"deepObject","explode":true,"name":"include","in":"query"},"82194b2a-f3d9-4f23-965a-b3001fac97c0":{"schema":{"type":"string","enum":["name","email","jobTitle","id"],"default":"name","title":"Sort field","description":"Field used to order results. Supported values depend on this listing. Defaults to name.","example":"name","isRequired":false,"uniqueKey":"","typeLabel":"enum\u003cstring>"},"required":false,"description":"Field used to order results. Supported values depend on this listing. Defaults to name.","name":"sortProperty","in":"query"},"097f44ac-095b-4308-9706-f07a213e4d5d":{"schema":{"type":"string","enum":["asc","desc"],"default":"asc","description":"Ascending or descending order. Defaults to asc.","title":"Sort direction","example":"asc","isRequired":false,"uniqueKey":"","typeLabel":"enum\u003cstring>"},"required":false,"description":"Ascending or descending order. Defaults to asc.","name":"sortDirection","in":"query"}},"responses":{"785ec30c-ec3b-425b-829e-ffd49dea2114":{"description":"List group members.","content":{"application/json":{"schema":{"type":"object","properties":{"members":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Opaque employee identifier in this company.","title":"Employee ID","example":"employee-avery","isRequired":true,"uniqueKey":"members.items.[INDEX].id","typeLabel":"string"},"firstName":{"oneOf":[{"type":"string","description":"Recorded employee first name, or null when unavailable.","title":"First name","example":"Avery","isRequired":true,"uniqueKey":"members.items.[INDEX].firstName.oneOf.0","typeLabel":"string"},{"type":"null","description":"Recorded employee first name, or null when unavailable.","title":"First name","example":"Avery","isRequired":true,"uniqueKey":"members.items.[INDEX].firstName.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"members.items.[INDEX].firstName","typeLabel":"string | null"},"lastName":{"oneOf":[{"type":"string","description":"Recorded employee last name, or null when unavailable.","title":"Last name","example":"Chen","isRequired":true,"uniqueKey":"members.items.[INDEX].lastName.oneOf.0","typeLabel":"string"},{"type":"null","description":"Recorded employee last name, or null when unavailable.","title":"Last name","example":"Chen","isRequired":true,"uniqueKey":"members.items.[INDEX].lastName.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"members.items.[INDEX].lastName","typeLabel":"string | null"},"displayFullName":{"oneOf":[{"type":"string","description":"Recorded employee display name, or null when unavailable.","title":"Display name","example":"Avery Chen","isRequired":true,"uniqueKey":"members.items.[INDEX].displayFullName.oneOf.0","typeLabel":"string"},{"type":"null","description":"Recorded employee display name, or null when unavailable.","title":"Display name","example":"Avery Chen","isRequired":true,"uniqueKey":"members.items.[INDEX].displayFullName.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"members.items.[INDEX].displayFullName","typeLabel":"string | null"},"avatarUrl":{"oneOf":[{"type":"string","description":"Avatar URL, or null when no avatar is available.","title":"Avatar URL","example":null,"isRequired":true,"uniqueKey":"members.items.[INDEX].avatarUrl.oneOf.0","typeLabel":"string"},{"type":"null","description":"Avatar URL, or null when no avatar is available.","title":"Avatar URL","example":null,"isRequired":true,"uniqueKey":"members.items.[INDEX].avatarUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"members.items.[INDEX].avatarUrl","typeLabel":"string | null"},"primaryEmail":{"oneOf":[{"type":"string","description":"Primary employee email, or null when unavailable.","title":"Primary email","example":"avery@example.test","isRequired":true,"uniqueKey":"members.items.[INDEX].primaryEmail.oneOf.0","typeLabel":"string"},{"type":"null","description":"Primary employee email, or null when unavailable.","title":"Primary email","example":"avery@example.test","isRequired":true,"uniqueKey":"members.items.[INDEX].primaryEmail.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"members.items.[INDEX].primaryEmail","typeLabel":"string | null"},"jobTitle":{"oneOf":[{"type":"string","description":"Recorded employee job title, or null when unavailable.","title":"Job title","example":"Engineer","isRequired":true,"uniqueKey":"members.items.[INDEX].jobTitle.oneOf.0","typeLabel":"string"},{"type":"null","description":"Recorded employee job title, or null when unavailable.","title":"Job title","example":"Engineer","isRequired":true,"uniqueKey":"members.items.[INDEX].jobTitle.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"members.items.[INDEX].jobTitle","typeLabel":"string | null"}},"required":["id","firstName","lastName","displayFullName","avatarUrl","primaryEmail","jobTitle"],"title":"Group employee","description":"An org-chart employee, independent of workspace membership.","example":{"id":"employee-avery","firstName":"Avery","lastName":"Chen","displayFullName":"Avery Chen","avatarUrl":null,"primaryEmail":"avery@example.test","jobTitle":"Engineer"},"uniqueKey":"members.items.[INDEX]","typeLabel":"Group employee · object"},"description":"Matching non-archived employees in the group. They need not have workspace membership.","title":"Employees","example":[{"id":"employee-avery","firstName":"Avery","lastName":"Chen","displayFullName":"Avery Chen","avatarUrl":null,"primaryEmail":"avery@example.test","jobTitle":"Engineer"}],"isRequired":true,"uniqueKey":"members","typeLabel":"Group employee · object[]"},"pagination":{"type":"object","properties":{"page":{"type":"integer","minimum":1,"default":1,"description":"One-based page number. Defaults to 1.","title":"Page number","example":1,"isRequired":true,"uniqueKey":"pagination.page","typeLabel":"integer"},"pageSize":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"Maximum results per page, from 1 to 100. Defaults to 50.","title":"Page size","example":50,"isRequired":true,"uniqueKey":"pagination.pageSize","typeLabel":"integer"},"hasMore":{"type":"boolean","description":"Whether there are more matching results after this page.","title":"Has another page","example":false,"isRequired":true,"uniqueKey":"pagination.hasMore","typeLabel":"boolean"},"total":{"type":"integer","minimum":0,"description":"Total matching items, independent of pagination. The route determines the item type.","title":"Total matches","example":1,"uniqueKey":"pagination.total","typeLabel":"integer"}},"required":["page","pageSize","hasMore"],"title":"Group pagination","example":{"page":1,"pageSize":50,"hasMore":false,"total":1},"description":"Page position and optional total count.","isRequired":true,"uniqueKey":"pagination","typeLabel":"Group pagination · object"}},"required":["members","pagination"],"title":"Group members response","description":"Current non-archived roster page and optional matching count.","example":{"members":[{"id":"employee-avery","firstName":"Avery","lastName":"Chen","displayFullName":"Avery Chen","avatarUrl":null,"primaryEmail":"avery@example.test","jobTitle":"Engineer"}],"pagination":{"page":1,"pageSize":50,"hasMore":false,"total":1}},"uniqueKey":"","typeLabel":"Group members response · object"},"examples":{"Example":{"title":"Example","value":{"members":[{"id":"employee-avery","firstName":"Avery","lastName":"Chen","displayFullName":"Avery Chen","avatarUrl":null,"primaryEmail":"avery@example.test","jobTitle":"Engineer"}],"pagination":{"page":1,"pageSize":50,"hasMore":false,"total":1}}}},"exampleType":"generated"}},"exampleType":"generated"},"d47d59a6-7d51-4800-bdbd-ddfc9104fab4":{"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"},"ef749465-9081-4d5f-8e81-a1add54b7d02":{"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"},"b38463b5-45ad-4010-bcdf-22ea82808188":{"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"},"8f155b09-1796-48a1-bc47-0a07f433a7c8":{"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"},"ca8fa597-1970-4629-9f48-6c2d82d55e25":{"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":{"c6f5a23d-d0fd-4c90-be5c-5f93030c5f44":{"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":{"bc3cc9da-1158-4cfa-97b3-e455483a1d98":{"url":"https://api.gowindmill.com/api/v2"}},"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":"List employees in a group - Windmill Help Site","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-19T14:24:43.886Z","originalFileLocation":"api-reference/groups/list-employees-in-a-group.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=\"Lists non-archived employees in a group that you can read, whether or not they have workspace access. Access to this list comes from the group; individual employee profile visibility does not further limit it. Supports employee-name search. Pages start at 1; pageSize defaults to 50 and is limited to 100. Request include.total for the matching count. Continue while pagination.hasMore is true. The default name order is last name, first name, then employee ID. Other sorts use the selected field, then employee ID. Missing, archived, or inaccessible groups return 404.\">\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=\"List employees in a group - Windmill Help Site\">\u003cmeta data-mint-head property=\"og:description\" content=\"Lists non-archived employees in a group that you can read, whether or not they have workspace access. Access to this list comes from the group; individual employee profile visibility does not further limit it. Supports employee-name search. Pages start at 1; pageSize defaults to 50 and is limited to 100. Request include.total for the matching count. Continue while pagination.hasMore is true. The default name order is last name, first name, then employee ID. Other sorts use the selected field, then employee ID. Missing, archived, or inaccessible groups return 404.\">\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/groups/list-employees-in-a-group\">\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=Groups\u0026amp;title=List+employees+in+a+group\u0026amp;description=Lists+non-archived+employees+in+a+group+that+you+can+read%2C+whether+or+not+they+have+workspace+access.+Access+to+this+list+comes+from+the+group%3B+individual+emplo\u0026amp;theme=819f4f407f94f51efe0e1a0f\u0026amp;signature=8b0fe3852beb306b5aff1fb134a447f8e0ba9bf71461c05a5d6fc345cd8be70f\">\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=\"List employees in a group - Windmill Help Site\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Lists non-archived employees in a group that you can read, whether or not they have workspace access. Access to this list comes from the group; individual employee profile visibility does not further limit it. Supports employee-name search. Pages start at 1; pageSize defaults to 50 and is limited to 100. Request include.total for the matching count. Continue while pagination.hasMore is true. The default name order is last name, first name, then employee ID. Other sorts use the selected field, then employee ID. Missing, archived, or inaccessible groups return 404.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://windmill.mintlify.site/_mintlify/api/og/v2?division=Groups\u0026amp;title=List+employees+in+a+group\u0026amp;description=Lists+non-archived+employees+in+a+group+that+you+can+read%2C+whether+or+not+they+have+workspace+access.+Access+to+this+list+comes+from+the+group%3B+individual+emplo\u0026amp;theme=819f4f407f94f51efe0e1a0f\u0026amp;signature=8b0fe3852beb306b5aff1fb134a447f8e0ba9bf71461c05a5d6fc345cd8be70f\">\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/groups/list-employees-in-a-group\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/groups/list-employees-in-a-group.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/groups/list-employees-in-a-group#webpage\",\"url\":\"https://help.gowindmill.com/api-reference/groups/list-employees-in-a-group\",\"name\":\"List employees in a group\",\"description\":\"Lists non-archived employees in a group that you can read, whether or not they have workspace access. Access to this list comes from the group; individual employee profile visibility does not further limit it. Supports employee-name search. Pages start at 1; pageSize defaults to 50 and is limited to 100. Request include.total for the matching count. Continue while pagination.hasMore is true. The default name order is last name, first name, then employee ID. Other sorts use the selected field, then employee ID. Missing, archived, or inaccessible groups return 404.\",\"dateModified\":\"2026-11-19T14:24:43.886Z\",\"isPartOf\":{\"@id\":\"https://help.gowindmill.com#website\"},\"breadcrumb\":{\"@id\":\"https://help.gowindmill.com/api-reference/groups/list-employees-in-a-group#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://help.gowindmill.com/api-reference/groups/list-employees-in-a-group#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://help.gowindmill.com/api-reference/employees/search-employee-profiles\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Groups\",\"item\":\"https://help.gowindmill.com/api-reference/groups/list-readable-employee-groups\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"List employees in a group\",\"item\":\"https://help.gowindmill.com/api-reference/groups/list-employees-in-a-group\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://help.gowindmill.com/api-reference/groups/list-employees-in-a-group#apireference\",\"headline\":\"List employees in a group\",\"name\":\"List employees in a group\",\"description\":\"Lists non-archived employees in a group that you can read, whether or not they have workspace access. Access to this list comes from the group; individual employee profile visibility does not further limit it. Supports employee-name search. Pages start at 1; pageSize defaults to 50 and is limited to 100. Request include.total for the matching count. Continue while pagination.hasMore is true. The default name order is last name, first name, then employee ID. Other sorts use the selected field, then employee ID. Missing, archived, or inaccessible groups return 404.\",\"url\":\"https://help.gowindmill.com/api-reference/groups/list-employees-in-a-group\",\"mainEntityOfPage\":{\"@id\":\"https://help.gowindmill.com/api-reference/groups/list-employees-in-a-group#webpage\"},\"dateModified\":\"2026-11-19T14:24:43.886Z\",\"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/groups/list-employees-in-a-group.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":"Employees","pages":[{"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":"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"}]},{"group":"Groups","pages":[{"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","description":"Updates the name and categories together; if either is invalid, neither changes. Names are trimmed, contain 1–200 characters, and can be changed only for MANUAL and FILTER groups. Renaming SCIM or SYNCED groups returns 400. categoryIds replaces all categories for any group type with up to 100 active company category UUIDs. Repeated IDs are used once; an empty list removes all categories. Omitted properties keep their values; an empty object is accepted. Type, rules, membership, and sharing are unchanged. Requires permission to edit the 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","description":"Counts non-archived employees in a group that you can read, using the same name search as GET /c/{companyId}/groups/{groupId}/members. Returns only the count. Access comes from the group; individual employee profile visibility does not further limit the count. Missing, archived, inaccessible, or out-of-company groups return 404.","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":"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"}]}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]},{"tab":"Best practices","pages":[{"title":"Best practices","href":"/introducing-windmill"}]}]},"basePath":"","title":"List employees in a group - Windmill Help Site","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CrDfRf61.js","snippetPresets-Dv-cOUrx.js","utils-BUTreAgv.js","style-to-object-BY3JEAdk.js","utils-wsznt9RM.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DEsMlaPy.js","conditional-requirements-CFM0id0Q.js","cloneDeep-DontW4xJ.js","_Uint8Array-pP7X6_RM.js","isObject-FP1Yky1u.js","ApiExamples-CU_aGGP0.js","usePlaygroundInputsStore-7dNmUIbS.js","shallow-fTtruD8x.js","isEqual-BRfNFpSD.js","CodeSnippets-52884wUJ.js","CodeSnippet-eoRjC4Le.js","getApiPlaygroundDisplay-CZyAPlR2.js","Page-Cr9IwkK7.js","DynamicMarkdown-NFqqduU7.js","SectionHeading-DQ-mJoAt.js","icon-DXTBUt6s.js","MethodPill-2v-b3js5.js","getPastedJson-v_8Y1_4v.js","DuplicateIcon-DXIkhZIo.js","createIcon-DRpYuPZs.js","axios-CsQoIw0U.js","Markdown-CwtoSfEf.js","AssistantPageLink-CTqa3eoi.js","dist-DIfYWxfm.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}