Maps an identity-provider group name to a Team in the authenticated service
account’s organization. Creating the same exact mapping again returns the existing
mapping with 201. Memberships change only during each user’s next reconciliation.
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"CrewAI Platform","colors":{"primary":"#EB6658","light":"#F3A78B","dark":"#C94C3C"},"logo":{"light":"https://mintcdn.com/crew-ai-platform-docs/UNPfV6xa2W35M-FA/images/crew_only_logo.png?fit=max\u0026auto=format\u0026n=UNPfV6xa2W35M-FA\u0026q=85\u0026s=26a26b1f1196dc2092395575ed72acce","dark":"https://mintcdn.com/crew-ai-platform-docs/UNPfV6xa2W35M-FA/images/crew_only_logo.png?fit=max\u0026auto=format\u0026n=UNPfV6xa2W35M-FA\u0026q=85\u0026s=26a26b1f1196dc2092395575ed72acce"},"favicon":"https://mintcdn.com/crew-ai-platform-docs/UNPfV6xa2W35M-FA/images/favicon.svg?fit=max\u0026auto=format\u0026n=UNPfV6xa2W35M-FA\u0026q=85\u0026s=bba15f251db0da821fee77b2b9762fd3","appearance":{"default":"system","strict":false},"background":{"decoration":"grid"},"navbar":{"links":[{"icon":"arrow-up-right-from-square","href":"https://app.crewai.com","label":"Start Cloud Trial"}],"primary":{"type":"github","href":"https://github.com/crewAIInc/crewAI"}},"footer":{"socials":{"website":"https://crewai.com","x":"https://x.com/crewAIInc","github":"https://github.com/crewAIInc/crewAI","linkedin":"https://www.linkedin.com/company/crewai-inc","youtube":"https://youtube.com/@crewAIInc","reddit":"https://www.reddit.com/r/crewAIInc"}},"seo":{"metatags":{"og:type":"website","og:site_name":"CrewAI Platform Documentation","og:image":"https://docs.crewai.com/images/crew_only_logo.png","twitter:card":"summary_large_image","twitter:site":"@crewAIInc","keywords":"CrewAI Platform, AI agents, multi-agent systems, automation"}},"fonts":{"family":"Inter"},"errors":{"404":{"redirect":true}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","href":"platform/en/introduction"},{"language":"pt-BR","href":"platform/pt-BR/introduction"},{"language":"ko","href":"platform/ko/introduction"},{"language":"ar","href":"platform/ar/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"crew-ai-platform-docs","hasAudioNarration":false,"actualSubdomain":"crew-ai-platform-docs","customDomains":["docs-platform.crewai.com"],"gitSource":{"type":"github","owner":"crewaiinc","repo":"crewai-platform-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"collectionId":"ddedae8d-9122-4cc1-8b11-a7c4ccff2c31","liveDeploymentHistoryId":"6ae9ed1fc43360bf59403a50","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae9ed1fc43360bf59403a50"},"entitlements":{},"buildId":"6ae9ed1fc43360bf59403a50","clientVersion":"0.0.4054","searchFilterCounts":[{"language":"en","tag":"API Reference","count":88},{"language":"en","tag":"Platform","count":87},{"language":"ar","tag":"المنصة","count":85},{"language":"ko","tag":"플랫폼","count":85},{"language":"pt-BR","tag":"Plataforma","count":85},{"language":"en","tag":"Platform API reference","count":78},{"language":"en","tag":"Integration Docs","count":28},{"language":"ar","tag":"التكاملات","count":28},{"language":"ko","tag":"통합 문서","count":28},{"language":"pt-BR","tag":"Documentação de Integração","count":28},{"language":"en","tag":"How-To Guides","count":19},{"language":"ar","tag":"How-To Guides","count":19},{"language":"ko","tag":"How-To Guides","count":19},{"language":"pt-BR","tag":"Guias","count":19},{"language":"en","tag":"Automations","count":17},{"language":"en","tag":"Teams","count":17},{"language":"en","tag":"Manage","count":14},{"language":"ar","tag":"الإدارة","count":13},{"language":"ko","tag":"관리","count":13},{"language":"pt-BR","tag":"Gerenciar","count":13},{"language":"en","tag":"Triggers","count":11},{"language":"ar","tag":"المشغّلات","count":11},{"language":"ko","tag":"트리거","count":11},{"language":"pt-BR","tag":"Triggers","count":11},{"language":"en","tag":"Getting started","count":10},{"language":"ar","tag":"Secrets Manager","count":9},{"language":"ko","tag":"Secrets Manager","count":9},{"language":"pt-BR","tag":"Secrets Manager","count":9},{"language":"ar","tag":"البناء","count":8},{"language":"ko","tag":"빌드","count":8},{"language":"pt-BR","tag":"Construir","count":8},{"language":"ar","tag":"العمليات","count":4},{"language":"ko","tag":"운영","count":4},{"language":"pt-BR","tag":"Operar","count":4},{"language":"ar","tag":"Agent Control Plane","count":3},{"language":"ar","tag":"الاستوديو","count":3},{"language":"ko","tag":"Agent Control Plane","count":3},{"language":"ko","tag":"Studio","count":3},{"language":"pt-BR","tag":"Agent Control Plane","count":3},{"language":"pt-BR","tag":"Studio","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","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":"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":"llms-txt-v2","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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"sso-setup-deadline-banner","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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api/v1/reference/group-mappings/create-a-group-mapping","slug":"/api/v1/reference/group-mappings/create-a-group-mapping","pageMetadata":{"title":"Create a group mapping","description":"Maps an identity-provider group name to a Team in the authenticated service\naccount's organization. Creating the same exact mapping again returns the existing\nmapping with 201. Memberships change only during each user's next reconciliation.\n","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml post /api/v1/group-mappings","href":"/api/v1/reference/group-mappings/create-a-group-mapping","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: \"Maps an identity-provider group name to a Team in the authenticated service\\naccount’s organization. Creating the same exact mapping again returns the existing\\nmapping with 201. Memberships change only during each user’s next reconciliation.\"\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":"Create a group mapping","description":"Maps an identity-provider group name to a Team in the authenticated service\naccount's organization. Creating the same exact mapping again returns the existing\nmapping with 201. Memberships change only during each user's next reconciliation.\n","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml post /api/v1/group-mappings","href":"/api/v1/reference/group-mappings/create-a-group-mapping","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create a group mapping","operationId":"createGroupMapping","description":"Maps an identity-provider group name to a Team in the authenticated service\naccount's organization. Creating the same exact mapping again returns the existing\nmapping with 201. Memberships change only during each user's next reconciliation.\n","tags":["Group Mappings"],"parameters":[],"responses":{"201":"916fdbb8-cbe0-4e53-ba03-a4f8b9b0eb2d","400":"96e67f4c-64a0-404d-a67f-b48854c72e36","401":"4860d89b-d16d-4d25-aef0-312d37c201a8","403":"37557b5e-e623-46da-81b3-25be858ba246","404":"5ba91cd1-b110-4d71-a4b4-e593c6e67d17","422":"13a4352e-ca56-4c6d-a716-abb82e751ce5"},"requestBody":"10752a28-6959-40af-b758-906669012082","method":"post","type":"path","servers":["b7092a84-65a9-49e2-9cf4-561df1e7c7e0"],"security":["355685ae-90db-45f5-8967-ca1785cf9c48"],"path":"/api/v1/group-mappings","baseUrlOptions":["https://app.crewai.com"],"title":"Create a group mapping","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"group_name":{"type":"string","example":"Engineering","minLength":1,"maxLength":255,"description":"Case-sensitive identity-provider group name. Surrounding whitespace is removed.","isRequired":true,"uniqueKey":"group_name","typeLabel":"string"},"team_id":{"type":"string","format":"uuid","example":"4f6d0d9a-7b78-4c6a-b64f-2e2e3d2c8f9a","isRequired":true,"uniqueKey":"team_id","typeLabel":"string\u003cuuid>"}},"required":["group_name","team_id"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"group_name":"Engineering","team_id":"4f6d0d9a-7b78-4c6a-b64f-2e2e3d2c8f9a"}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"916fdbb8-cbe0-4e53-ba03-a4f8b9b0eb2d":{"description":"Created","content":{"application/json":{"examples":{"created":{"title":"created","value":{"data":{"id":"4f6d0d9a-7b78-4c6a-b64f-2e2e3d2c8f9a","group_name":"Engineering","team":{"id":"4f6d0d9a-7b78-4c6a-b64f-2e2e3d2c8f9a","name":"Builders"},"created_at":"2026-07-07T00:00:00Z","updated_at":"2026-07-07T00:00:00Z"}}}},"schema":{"type":"object","required":["data"],"additionalProperties":false,"properties":{"data":{"type":"object","required":["id","group_name","team","created_at","updated_at"],"additionalProperties":false,"properties":{"id":{"type":"string","format":"uuid","example":"4f6d0d9a-7b78-4c6a-b64f-2e2e3d2c8f9a","isRequired":true,"uniqueKey":"data.id","typeLabel":"string\u003cuuid>"},"group_name":{"type":"string","example":"Engineering","description":"Exact, case-sensitive identity-provider group name.","isRequired":true,"uniqueKey":"data.group_name","typeLabel":"string"},"team":{"type":"object","required":["id","name"],"additionalProperties":false,"properties":{"id":{"type":"string","format":"uuid","example":"4f6d0d9a-7b78-4c6a-b64f-2e2e3d2c8f9a","isRequired":true,"uniqueKey":"data.team.id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","example":"Builders","isRequired":true,"uniqueKey":"data.team.name","typeLabel":"string"}},"isRequired":true,"uniqueKey":"data.team","typeLabel":"object"},"created_at":{"type":"string","format":"date-time","example":"2026-07-07T00:00:00Z","isRequired":true,"uniqueKey":"data.created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","example":"2026-07-07T00:00:00Z","isRequired":true,"uniqueKey":"data.updated_at","typeLabel":"string\u003cdate-time>"}},"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"exampleType":"examples"},"96e67f4c-64a0-404d-a67f-b48854c72e36":{"description":"Bad Request","content":{"application/json":{"examples":{"missing_team_id":{"title":"missing_team_id","value":{"errors":[{"type":"https://docs-platform.crewai.com/api/problems/bad_request","code":"bad_request","title":"Bad request","status":400,"detail":"The request is invalid."}]}},"missing_group_name":{"title":"missing_group_name","value":{"errors":[{"type":"https://docs-platform.crewai.com/api/problems/bad_request","code":"bad_request","title":"Bad request","status":400,"detail":"The request is invalid."}]}},"blank_group_name":{"title":"blank_group_name","value":{"errors":[{"type":"https://docs-platform.crewai.com/api/problems/bad_request","code":"bad_request","title":"Bad request","status":400,"detail":"The request is invalid."}]}}},"schema":{"type":"object","required":["errors"],"additionalProperties":false,"properties":{"errors":{"type":"array","minItems":1,"items":{"type":"object","description":"Public API error object.","required":["type","code","title","status","detail"],"additionalProperties":false,"properties":{"type":{"type":"string","format":"uri","enum":["https://docs-platform.crewai.com/api/problems/bad_request","https://docs-platform.crewai.com/api/problems/clipper_disabled","https://docs-platform.crewai.com/api/problems/clipper_disallowed","https://docs-platform.crewai.com/api/problems/clipper_feature_disabled","https://docs-platform.crewai.com/api/problems/clipper_not_found","https://docs-platform.crewai.com/api/problems/conflict","https://docs-platform.crewai.com/api/problems/forbidden","https://docs-platform.crewai.com/api/problems/internal_error","https://docs-platform.crewai.com/api/problems/not_found","https://docs-platform.crewai.com/api/problems/service_unavailable","https://docs-platform.crewai.com/api/problems/tool_execution_failed","https://docs-platform.crewai.com/api/problems/unauthorized","https://docs-platform.crewai.com/api/problems/validation_error"],"example":"https://docs-platform.crewai.com/api/problems/bad_request","isRequired":true,"uniqueKey":"errors.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","enum":["bad_request","clipper_disabled","clipper_disallowed","clipper_feature_disabled","clipper_not_found","conflict","forbidden","internal_error","not_found","service_unavailable","tool_execution_failed","unauthorized","validation_error"],"example":"bad_request","isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"enum\u003cstring>"},"title":{"type":"string","x-crewai-enum-format":"freeform","enum":["Bad request","Clipper resource disabled","Clipper resource disallowed","Clipper feature disabled","Clipper resource not found","Conflict","Forbidden","Internal error","Not found","Service unavailable","Tool execution failed","Unauthorized","Validation error"],"example":"Bad request","isRequired":true,"uniqueKey":"errors.items.[INDEX].title","typeLabel":"enum\u003cstring>"},"status":{"type":"integer","enum":[400,401,403,404,409,422,500,503],"example":400,"isRequired":true,"uniqueKey":"errors.items.[INDEX].status","typeLabel":"enum\u003cinteger>"},"detail":{"type":"string","example":"The request is invalid.","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"exampleType":"examples"},"4860d89b-d16d-4d25-aef0-312d37c201a8":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"title":"unauthorized","value":{"errors":[{"type":"https://docs-platform.crewai.com/api/problems/unauthorized","code":"unauthorized","title":"Unauthorized","status":401,"detail":"Missing or invalid bearer token."}]}}},"schema":{"type":"object","required":["errors"],"additionalProperties":false,"properties":{"errors":{"type":"array","minItems":1,"items":{"type":"object","description":"Public API error object.","required":["type","code","title","status","detail"],"additionalProperties":false,"properties":{"type":{"type":"string","format":"uri","enum":["https://docs-platform.crewai.com/api/problems/bad_request","https://docs-platform.crewai.com/api/problems/clipper_disabled","https://docs-platform.crewai.com/api/problems/clipper_disallowed","https://docs-platform.crewai.com/api/problems/clipper_feature_disabled","https://docs-platform.crewai.com/api/problems/clipper_not_found","https://docs-platform.crewai.com/api/problems/conflict","https://docs-platform.crewai.com/api/problems/forbidden","https://docs-platform.crewai.com/api/problems/internal_error","https://docs-platform.crewai.com/api/problems/not_found","https://docs-platform.crewai.com/api/problems/service_unavailable","https://docs-platform.crewai.com/api/problems/tool_execution_failed","https://docs-platform.crewai.com/api/problems/unauthorized","https://docs-platform.crewai.com/api/problems/validation_error"],"example":"https://docs-platform.crewai.com/api/problems/bad_request","isRequired":true,"uniqueKey":"errors.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","enum":["bad_request","clipper_disabled","clipper_disallowed","clipper_feature_disabled","clipper_not_found","conflict","forbidden","internal_error","not_found","service_unavailable","tool_execution_failed","unauthorized","validation_error"],"example":"bad_request","isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"enum\u003cstring>"},"title":{"type":"string","x-crewai-enum-format":"freeform","enum":["Bad request","Clipper resource disabled","Clipper resource disallowed","Clipper feature disabled","Clipper resource not found","Conflict","Forbidden","Internal error","Not found","Service unavailable","Tool execution failed","Unauthorized","Validation error"],"example":"Bad request","isRequired":true,"uniqueKey":"errors.items.[INDEX].title","typeLabel":"enum\u003cstring>"},"status":{"type":"integer","enum":[400,401,403,404,409,422,500,503],"example":400,"isRequired":true,"uniqueKey":"errors.items.[INDEX].status","typeLabel":"enum\u003cinteger>"},"detail":{"type":"string","example":"The request is invalid.","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"exampleType":"examples"},"37557b5e-e623-46da-81b3-25be858ba246":{"description":"Forbidden","content":{"application/json":{"examples":{"rbac_v2_disabled":{"title":"rbac_v2_disabled","value":{"errors":[{"type":"https://docs-platform.crewai.com/api/problems/forbidden","code":"forbidden","title":"Forbidden","status":403,"detail":"Teams are not available for your organization."}]}}},"schema":{"type":"object","required":["errors"],"additionalProperties":false,"properties":{"errors":{"type":"array","minItems":1,"items":{"type":"object","description":"Public API error object.","required":["type","code","title","status","detail"],"additionalProperties":false,"properties":{"type":{"type":"string","format":"uri","enum":["https://docs-platform.crewai.com/api/problems/bad_request","https://docs-platform.crewai.com/api/problems/clipper_disabled","https://docs-platform.crewai.com/api/problems/clipper_disallowed","https://docs-platform.crewai.com/api/problems/clipper_feature_disabled","https://docs-platform.crewai.com/api/problems/clipper_not_found","https://docs-platform.crewai.com/api/problems/conflict","https://docs-platform.crewai.com/api/problems/forbidden","https://docs-platform.crewai.com/api/problems/internal_error","https://docs-platform.crewai.com/api/problems/not_found","https://docs-platform.crewai.com/api/problems/service_unavailable","https://docs-platform.crewai.com/api/problems/tool_execution_failed","https://docs-platform.crewai.com/api/problems/unauthorized","https://docs-platform.crewai.com/api/problems/validation_error"],"example":"https://docs-platform.crewai.com/api/problems/bad_request","isRequired":true,"uniqueKey":"errors.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","enum":["bad_request","clipper_disabled","clipper_disallowed","clipper_feature_disabled","clipper_not_found","conflict","forbidden","internal_error","not_found","service_unavailable","tool_execution_failed","unauthorized","validation_error"],"example":"bad_request","isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"enum\u003cstring>"},"title":{"type":"string","x-crewai-enum-format":"freeform","enum":["Bad request","Clipper resource disabled","Clipper resource disallowed","Clipper feature disabled","Clipper resource not found","Conflict","Forbidden","Internal error","Not found","Service unavailable","Tool execution failed","Unauthorized","Validation error"],"example":"Bad request","isRequired":true,"uniqueKey":"errors.items.[INDEX].title","typeLabel":"enum\u003cstring>"},"status":{"type":"integer","enum":[400,401,403,404,409,422,500,503],"example":400,"isRequired":true,"uniqueKey":"errors.items.[INDEX].status","typeLabel":"enum\u003cinteger>"},"detail":{"type":"string","example":"The request is invalid.","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"exampleType":"examples"},"5ba91cd1-b110-4d71-a4b4-e593c6e67d17":{"description":"Not Found","content":{"application/json":{"examples":{"foreign_team":{"title":"foreign_team","value":{"errors":[{"type":"https://docs-platform.crewai.com/api/problems/not_found","code":"not_found","title":"Not found","status":404,"detail":"The requested resource could not be found."}]}}},"schema":{"type":"object","required":["errors"],"additionalProperties":false,"properties":{"errors":{"type":"array","minItems":1,"items":{"type":"object","description":"Public API error object.","required":["type","code","title","status","detail"],"additionalProperties":false,"properties":{"type":{"type":"string","format":"uri","enum":["https://docs-platform.crewai.com/api/problems/bad_request","https://docs-platform.crewai.com/api/problems/clipper_disabled","https://docs-platform.crewai.com/api/problems/clipper_disallowed","https://docs-platform.crewai.com/api/problems/clipper_feature_disabled","https://docs-platform.crewai.com/api/problems/clipper_not_found","https://docs-platform.crewai.com/api/problems/conflict","https://docs-platform.crewai.com/api/problems/forbidden","https://docs-platform.crewai.com/api/problems/internal_error","https://docs-platform.crewai.com/api/problems/not_found","https://docs-platform.crewai.com/api/problems/service_unavailable","https://docs-platform.crewai.com/api/problems/tool_execution_failed","https://docs-platform.crewai.com/api/problems/unauthorized","https://docs-platform.crewai.com/api/problems/validation_error"],"example":"https://docs-platform.crewai.com/api/problems/bad_request","isRequired":true,"uniqueKey":"errors.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","enum":["bad_request","clipper_disabled","clipper_disallowed","clipper_feature_disabled","clipper_not_found","conflict","forbidden","internal_error","not_found","service_unavailable","tool_execution_failed","unauthorized","validation_error"],"example":"bad_request","isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"enum\u003cstring>"},"title":{"type":"string","x-crewai-enum-format":"freeform","enum":["Bad request","Clipper resource disabled","Clipper resource disallowed","Clipper feature disabled","Clipper resource not found","Conflict","Forbidden","Internal error","Not found","Service unavailable","Tool execution failed","Unauthorized","Validation error"],"example":"Bad request","isRequired":true,"uniqueKey":"errors.items.[INDEX].title","typeLabel":"enum\u003cstring>"},"status":{"type":"integer","enum":[400,401,403,404,409,422,500,503],"example":400,"isRequired":true,"uniqueKey":"errors.items.[INDEX].status","typeLabel":"enum\u003cinteger>"},"detail":{"type":"string","example":"The request is invalid.","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"exampleType":"examples"},"13a4352e-ca56-4c6d-a716-abb82e751ce5":{"description":"Unprocessable Content","content":{"application/json":{"examples":{"group_name_too_long":{"title":"group_name_too_long","value":{"errors":[{"type":"https://docs-platform.crewai.com/api/problems/validation_error","code":"validation_error","title":"Validation error","status":422,"detail":"Group name is too long (maximum is 255 characters)"}]}}},"schema":{"type":"object","required":["errors"],"additionalProperties":false,"properties":{"errors":{"type":"array","minItems":1,"items":{"type":"object","description":"Public API error object.","required":["type","code","title","status","detail"],"additionalProperties":false,"properties":{"type":{"type":"string","format":"uri","enum":["https://docs-platform.crewai.com/api/problems/bad_request","https://docs-platform.crewai.com/api/problems/clipper_disabled","https://docs-platform.crewai.com/api/problems/clipper_disallowed","https://docs-platform.crewai.com/api/problems/clipper_feature_disabled","https://docs-platform.crewai.com/api/problems/clipper_not_found","https://docs-platform.crewai.com/api/problems/conflict","https://docs-platform.crewai.com/api/problems/forbidden","https://docs-platform.crewai.com/api/problems/internal_error","https://docs-platform.crewai.com/api/problems/not_found","https://docs-platform.crewai.com/api/problems/service_unavailable","https://docs-platform.crewai.com/api/problems/tool_execution_failed","https://docs-platform.crewai.com/api/problems/unauthorized","https://docs-platform.crewai.com/api/problems/validation_error"],"example":"https://docs-platform.crewai.com/api/problems/bad_request","isRequired":true,"uniqueKey":"errors.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","enum":["bad_request","clipper_disabled","clipper_disallowed","clipper_feature_disabled","clipper_not_found","conflict","forbidden","internal_error","not_found","service_unavailable","tool_execution_failed","unauthorized","validation_error"],"example":"bad_request","isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"enum\u003cstring>"},"title":{"type":"string","x-crewai-enum-format":"freeform","enum":["Bad request","Clipper resource disabled","Clipper resource disallowed","Clipper feature disabled","Clipper resource not found","Conflict","Forbidden","Internal error","Not found","Service unavailable","Tool execution failed","Unauthorized","Validation error"],"example":"Bad request","isRequired":true,"uniqueKey":"errors.items.[INDEX].title","typeLabel":"enum\u003cstring>"},"status":{"type":"integer","enum":[400,401,403,404,409,422,500,503],"example":400,"isRequired":true,"uniqueKey":"errors.items.[INDEX].status","typeLabel":"enum\u003cinteger>"},"detail":{"type":"string","example":"The request is invalid.","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"355685ae-90db-45f5-8967-ca1785cf9c48":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"opaque","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"b7092a84-65a9-49e2-9cf4-561df1e7c7e0":{"url":"https://app.crewai.com","description":"Current CrewAI Platform host"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"opaque","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi/platform-v1.yaml"},"subdomain":"crew-ai-platform-docs","siteName":"CrewAI Platform","title":"Create a group mapping - CrewAI Platform","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api/v1/reference/group-mappings/create-a-group-mapping","matchLevel":0},"pt-BR":{"href":"/platform/pt-BR/introduction","matchLevel":4},"ko":{"href":"/platform/ko/introduction","matchLevel":4},"ar":{"href":"/platform/ar/introduction","matchLevel":4}}},"lastModified":"2026-11-03T14:18:19.987Z","originalFileLocation":"api/v1/reference/group-mappings/create-a-group-mapping.mdx","locale":"en"},"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=\"Maps an identity-provider group name to a Team in the authenticated service account\u0026#x27;s organization. Creating the same exact mapping again returns the existing mapping with 201. Memberships change only during each user\u0026#x27;s next reconciliation.\">\u003cmeta data-mint-head name=\"keywords\" content=\"CrewAI Platform, AI agents, multi-agent systems, automation\">\u003cmeta data-mint-head name=\"application-name\" content=\"CrewAI Platform\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/crew-ai-platform-docs/aRs_LPYy6hwBLJfb/_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/crew-ai-platform-docs/aRs_LPYy6hwBLJfb/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/crew-ai-platform-docs/aRs_LPYy6hwBLJfb/_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/crew-ai-platform-docs/aRs_LPYy6hwBLJfb/_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/crew-ai-platform-docs/aRs_LPYy6hwBLJfb/_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/crew-ai-platform-docs/aRs_LPYy6hwBLJfb/_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/crew-ai-platform-docs/aRs_LPYy6hwBLJfb/_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/crew-ai-platform-docs/aRs_LPYy6hwBLJfb/_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/crew-ai-platform-docs/aRs_LPYy6hwBLJfb/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a group mapping - CrewAI Platform\">\u003cmeta data-mint-head property=\"og:description\" content=\"Maps an identity-provider group name to a Team in the authenticated service account\u0026#x27;s organization. Creating the same exact mapping again returns the existing mapping with 201. Memberships change only during each user\u0026#x27;s next reconciliation.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"CrewAI Platform Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs-platform.crewai.com/api/v1/reference/group-mappings/create-a-group-mapping\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://docs.crewai.com/images/crew_only_logo.png\">\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=\"Create a group mapping - CrewAI Platform\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Maps an identity-provider group name to a Team in the authenticated service account\u0026#x27;s organization. Creating the same exact mapping again returns the existing mapping with 201. Memberships change only during each user\u0026#x27;s next reconciliation.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://docs.crewai.com/images/crew_only_logo.png\">\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/crew-ai-platform-docs/aRs_LPYy6hwBLJfb/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"CrewAI Platform\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#EB6658\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs-platform.crewai.com/api/v1/reference/group-mappings/create-a-group-mapping\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api/v1/reference/group-mappings/create-a-group-mapping.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs-platform.crewai.com/#organization\",\"name\":\"CrewAI Platform\",\"url\":\"https://docs-platform.crewai.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/crew-ai-platform-docs/UNPfV6xa2W35M-FA/images/crew_only_logo.png?fit=max\u0026auto=format\u0026n=UNPfV6xa2W35M-FA\u0026q=85\u0026s=26a26b1f1196dc2092395575ed72acce\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs-platform.crewai.com#website\",\"name\":\"CrewAI Platform\",\"url\":\"https://docs-platform.crewai.com\",\"publisher\":{\"@id\":\"https://docs-platform.crewai.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs-platform.crewai.com/api/v1/reference/group-mappings/create-a-group-mapping#webpage\",\"url\":\"https://docs-platform.crewai.com/api/v1/reference/group-mappings/create-a-group-mapping\",\"name\":\"Create a group mapping\",\"description\":\"Maps an identity-provider group name to a Team in the authenticated service account's organization. Creating the same exact mapping again returns the existing mapping with 201. Memberships change only during each user's next reconciliation.\",\"dateModified\":\"2026-11-03T14:18:19.987Z\",\"isPartOf\":{\"@id\":\"https://docs-platform.crewai.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs-platform.crewai.com/api/v1/reference/group-mappings/create-a-group-mapping#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs-platform.crewai.com/api/v1/reference/group-mappings/create-a-group-mapping#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Platform API reference\",\"item\":\"https://docs-platform.crewai.com/api/v1/reference/applications/list-an-applications-tools\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Group Mappings\",\"item\":\"https://docs-platform.crewai.com/api/v1/reference/group-mappings/list-group-mappings\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create a group mapping\",\"item\":\"https://docs-platform.crewai.com/api/v1/reference/group-mappings/create-a-group-mapping\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs-platform.crewai.com/api/v1/reference/group-mappings/create-a-group-mapping#apireference\",\"headline\":\"Create a group mapping\",\"name\":\"Create a group mapping\",\"description\":\"Maps an identity-provider group name to a Team in the authenticated service account's organization. Creating the same exact mapping again returns the existing mapping with 201. Memberships change only during each user's next reconciliation.\",\"url\":\"https://docs-platform.crewai.com/api/v1/reference/group-mappings/create-a-group-mapping\",\"mainEntityOfPage\":{\"@id\":\"https://docs-platform.crewai.com/api/v1/reference/group-mappings/create-a-group-mapping#webpage\"},\"image\":\"https://docs.crewai.com/images/crew_only_logo.png\",\"dateModified\":\"2026-11-03T14:18:19.987Z\",\"publisher\":{\"@id\":\"https://docs-platform.crewai.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs-platform.crewai.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"CrewAI Platform\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"CrewAI Platform","nav":{"global":null,"languages":[{"language":"en","tabs":[{"tab":"Platform","icon":"briefcase","pages":[{"title":"Platform","href":"/platform/en/introduction"}]},{"tab":"API Reference","icon":"code","groups":[{"group":"Getting started","pages":[{"title":"Introduction","href":"/api/introduction"},{"title":"Service accounts","href":"/api/service-account"},{"group":"Authentication","pages":[{"title":"Create an access token","deprecated":null,"version":null,"openapi":"/openapi/platform-auth.yaml post /oauth/token","href":"/api-reference/authentication/create-an-access-token"}]},{"group":"Errors","pages":[{"title":"Error responses","href":"/api/problems"},{"title":"Bad request","href":"/api/problems/bad_request"},{"title":"Unauthorized","href":"/api/problems/unauthorized"},{"title":"Not found","href":"/api/problems/not_found"},{"title":"Conflict","href":"/api/problems/conflict"},{"title":"Validation error","href":"/api/problems/validation_error"},{"title":"Internal error","href":"/api/problems/internal_error"}]}]},{"group":"Platform API reference","pages":[{"group":"Applications","pages":[{"title":"List an application's tools","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/applications/{application_id}/tools","href":"/api/v1/reference/applications/list-an-applications-tools"},{"title":"List an application's triggers","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/applications/{application_id}/triggers","href":"/api/v1/reference/applications/list-an-applications-triggers"},{"title":"List applications","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/applications","href":"/api/v1/reference/applications/list-applications"},{"title":"Get an application","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/applications/{application_id}","href":"/api/v1/reference/applications/get-an-application"}]},{"group":"Automations","pages":[{"title":"Get an execution's trace summary","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/automations/{automation_id}/executions/{execution_id}/trace","href":"/api/v1/reference/automations/get-an-executions-trace-summary"},{"title":"List an execution's trace spans","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/automations/{automation_id}/executions/{execution_id}/trace/spans","href":"/api/v1/reference/automations/list-an-executions-trace-spans"},{"title":"Get one trace span","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/automations/{automation_id}/executions/{execution_id}/trace/spans/{span_id}","href":"/api/v1/reference/automations/get-one-trace-span"},{"title":"List an Automation's executions","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/automations/{automation_id}/executions","href":"/api/v1/reference/automations/list-an-automations-executions"},{"title":"Get an execution of an Automation","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/automations/{automation_id}/executions/{execution_id}","href":"/api/v1/reference/automations/get-an-execution-of-an-automation"},{"title":"List an Automation's schedules","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/automations/{automation_id}/schedules","href":"/api/v1/reference/automations/list-an-automations-schedules"},{"title":"Get a schedule of an Automation","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/automations/{automation_id}/schedules/{schedule_id}","href":"/api/v1/reference/automations/get-a-schedule-of-an-automation"},{"title":"Upload an Automation ZIP","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml post /api/v1/automation-uploads","href":"/api/v1/reference/automations/upload-an-automation-zip"},{"title":"List Automations","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/automations","href":"/api/v1/reference/automations/list-automations"},{"title":"Create an Automation","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml post /api/v1/automations","href":"/api/v1/reference/automations/create-an-automation"},{"title":"Redeploy an Automation","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml post /api/v1/automations/{id}/redeploy","href":"/api/v1/reference/automations/redeploy-an-automation"},{"title":"Get an Automation","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/automations/{id}","href":"/api/v1/reference/automations/get-an-automation"},{"title":"Delete an Automation","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml delete /api/v1/automations/{id}","href":"/api/v1/reference/automations/delete-an-automation"},{"title":"Export an Automation ZIP","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/automations/{id}/export","href":"/api/v1/reference/automations/export-an-automation-zip"},{"title":"List the roles granted on an automation","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/automations/{automation_id}/granted-roles","href":"/api/v1/reference/automations/list-the-roles-granted-on-an-automation"},{"title":"Grant a role on an automation","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml post /api/v1/automations/{automation_id}/granted-roles","href":"/api/v1/reference/automations/grant-a-role-on-an-automation"},{"title":"Revoke a role granted on an automation","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml delete /api/v1/automations/{automation_id}/granted-roles/{id}","href":"/api/v1/reference/automations/revoke-a-role-granted-on-an-automation"}]},{"group":"Group Mappings","pages":[{"title":"List group mappings","description":"Returns identity-provider group-to-Team mappings in the authenticated service account's organization.","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/group-mappings","href":"/api/v1/reference/group-mappings/list-group-mappings"},{"title":"Create a group mapping","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml post /api/v1/group-mappings","href":"/api/v1/reference/group-mappings/create-a-group-mapping"},{"title":"Delete a group mapping","description":"Deletes a group-to-Team mapping in the authenticated service account's organization.\nExisting Team memberships remain unchanged until each user's next reconciliation.\n","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml delete /api/v1/group-mappings/{id}","href":"/api/v1/reference/group-mappings/delete-a-group-mapping"}]},{"group":"Users","pages":[{"title":"Create invitations","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml post /api/v1/invites","href":"/api/v1/reference/users/create-invitations"},{"title":"List roles","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/roles","href":"/api/v1/reference/users/list-roles"},{"title":"List user granted roles","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/users/{user_id}/granted-roles","href":"/api/v1/reference/users/list-user-granted-roles"},{"title":"Assign a role to a user","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml post /api/v1/users/{user_id}/granted-roles","href":"/api/v1/reference/users/assign-a-role-to-a-user"},{"title":"Revoke a granted role","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml delete /api/v1/users/{user_id}/granted-roles/{id}","href":"/api/v1/reference/users/revoke-a-granted-role"},{"title":"List a user's teams","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/users/{user_id}/teams","href":"/api/v1/reference/users/list-a-users-teams"},{"title":"List users","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/users","href":"/api/v1/reference/users/list-users"},{"title":"Remove user","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml delete /api/v1/users/{id}","href":"/api/v1/reference/users/remove-user"}]},{"group":"Teams","pages":[{"title":"Request a Team membership source purge","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml post /api/v1/membership-sources/{source}/purge","href":"/api/v1/reference/teams/request-a-team-membership-source-purge"},{"title":"List Team membership sources","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/membership-sources","href":"/api/v1/reference/teams/list-team-membership-sources"},{"title":"Update a Team membership source","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml patch /api/v1/membership-sources/{source}","href":"/api/v1/reference/teams/update-a-team-membership-source"},{"title":"List team granted roles","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/teams/{team_id}/granted-roles","href":"/api/v1/reference/teams/list-team-granted-roles"},{"title":"Assign a role to a team","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml post /api/v1/teams/{team_id}/granted-roles","href":"/api/v1/reference/teams/assign-a-role-to-a-team"},{"title":"Revoke a team granted role","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml delete /api/v1/teams/{team_id}/granted-roles/{id}","href":"/api/v1/reference/teams/revoke-a-team-granted-role"},{"title":"List team service accounts","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/teams/{team_id}/service-accounts","href":"/api/v1/reference/teams/list-team-service-accounts"},{"title":"Add a service account to a team","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml post /api/v1/teams/{team_id}/service-accounts","href":"/api/v1/reference/teams/add-a-service-account-to-a-team"},{"title":"Remove a service account from a team","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml delete /api/v1/teams/{team_id}/service-accounts/{id}","href":"/api/v1/reference/teams/remove-a-service-account-from-a-team"},{"title":"List team users","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/teams/{team_id}/users","href":"/api/v1/reference/teams/list-team-users"},{"title":"Add a user to a team","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml post /api/v1/teams/{team_id}/users","href":"/api/v1/reference/teams/add-a-user-to-a-team"},{"title":"Remove a user from a team","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml delete /api/v1/teams/{team_id}/users/{id}","href":"/api/v1/reference/teams/remove-a-user-from-a-team"},{"title":"List teams","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/teams","href":"/api/v1/reference/teams/list-teams"},{"title":"Create a team","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml post /api/v1/teams","href":"/api/v1/reference/teams/create-a-team"},{"title":"Get a team","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/teams/{id}","href":"/api/v1/reference/teams/get-a-team"},{"title":"Delete a team","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml delete /api/v1/teams/{id}","href":"/api/v1/reference/teams/delete-a-team"},{"title":"Update a team","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml patch /api/v1/teams/{id}","href":"/api/v1/reference/teams/update-a-team"}]},{"group":"Environment Variables","pages":[{"title":"List the roles granted on an environment variable","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/environment-variables/{environment_variable_id}/granted-roles","href":"/api/v1/reference/environment-variables/list-the-roles-granted-on-an-environment-variable"},{"title":"Grant a role on an environment variable","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml post /api/v1/environment-variables/{environment_variable_id}/granted-roles","href":"/api/v1/reference/environment-variables/grant-a-role-on-an-environment-variable"},{"title":"Revoke a role granted on an environment variable","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml delete /api/v1/environment-variables/{environment_variable_id}/granted-roles/{id}","href":"/api/v1/reference/environment-variables/revoke-a-role-granted-on-an-environment-variable"}]},{"group":"Git Repositories","pages":[{"title":"List the roles granted on a git repository","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/git-repositories/{git_repository_id}/granted-roles","href":"/api/v1/reference/git-repositories/list-the-roles-granted-on-a-git-repository"},{"title":"Grant a role on a git repository","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml post /api/v1/git-repositories/{git_repository_id}/granted-roles","href":"/api/v1/reference/git-repositories/grant-a-role-on-a-git-repository"},{"title":"Revoke a role granted on a git repository","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml delete /api/v1/git-repositories/{git_repository_id}/granted-roles/{id}","href":"/api/v1/reference/git-repositories/revoke-a-role-granted-on-a-git-repository"}]},{"group":"LLM Connections","pages":[{"title":"List the roles granted on an LLM connection","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/llm-connections/{llm_connection_id}/granted-roles","href":"/api/v1/reference/llm-connections/list-the-roles-granted-on-an-llm-connection"},{"title":"Grant a role on an LLM connection","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml post /api/v1/llm-connections/{llm_connection_id}/granted-roles","href":"/api/v1/reference/llm-connections/grant-a-role-on-an-llm-connection"},{"title":"Revoke a role granted on an LLM connection","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml delete /api/v1/llm-connections/{llm_connection_id}/granted-roles/{id}","href":"/api/v1/reference/llm-connections/revoke-a-role-granted-on-an-llm-connection"}]},{"group":"Studio Projects","pages":[{"title":"List the roles granted on a Studio project","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/studio-projects/{studio_project_id}/granted-roles","href":"/api/v1/reference/studio-projects/list-the-roles-granted-on-a-studio-project"},{"title":"Grant a role on a Studio project","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml post /api/v1/studio-projects/{studio_project_id}/granted-roles","href":"/api/v1/reference/studio-projects/grant-a-role-on-a-studio-project"},{"title":"Revoke a role granted on a Studio project","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml delete /api/v1/studio-projects/{studio_project_id}/granted-roles/{id}","href":"/api/v1/reference/studio-projects/revoke-a-role-granted-on-a-studio-project"},{"title":"Delete a Studio Project","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml delete /api/v1/studio-projects/{id}","href":"/api/v1/reference/studio-projects/delete-a-studio-project"}]},{"group":"Tools","pages":[{"title":"List the roles granted on a tool","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/tools/{tool_id}/granted-roles","href":"/api/v1/reference/tools/list-the-roles-granted-on-a-tool"},{"title":"Grant a role on a tool","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml post /api/v1/tools/{tool_id}/granted-roles","href":"/api/v1/reference/tools/grant-a-role-on-a-tool"},{"title":"Revoke a role granted on a tool","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml delete /api/v1/tools/{tool_id}/granted-roles/{id}","href":"/api/v1/reference/tools/revoke-a-role-granted-on-a-tool"}]},{"group":"Service Accounts","pages":[{"title":"List service account granted roles","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/service-accounts/{service_account_id}/granted-roles","href":"/api/v1/reference/service-accounts/list-service-account-granted-roles"},{"title":"Assign a role to a service account","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml post /api/v1/service-accounts/{service_account_id}/granted-roles","href":"/api/v1/reference/service-accounts/assign-a-role-to-a-service-account"},{"title":"Revoke a service account granted role","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml delete /api/v1/service-accounts/{service_account_id}/granted-roles/{id}","href":"/api/v1/reference/service-accounts/revoke-a-service-account-granted-role"},{"title":"List a service account's teams","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/service-accounts/{service_account_id}/teams","href":"/api/v1/reference/service-accounts/list-a-service-accounts-teams"}]},{"group":"Status","pages":[{"title":"Check API status","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/status","href":"/api/v1/reference/status/check-api-status"}]},{"group":"Webhook Endpoints","pages":[{"title":"List webhook endpoints","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/webhook-endpoints","href":"/api/v1/reference/webhook-endpoints/list-webhook-endpoints"},{"title":"Create a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml post /api/v1/webhook-endpoints","href":"/api/v1/reference/webhook-endpoints/create-a-webhook-endpoint"},{"title":"Get a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/webhook-endpoints/{id}","href":"/api/v1/reference/webhook-endpoints/get-a-webhook-endpoint"},{"title":"Delete a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml delete /api/v1/webhook-endpoints/{id}","href":"/api/v1/reference/webhook-endpoints/delete-a-webhook-endpoint"},{"title":"Update a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml patch /api/v1/webhook-endpoints/{id}","href":"/api/v1/reference/webhook-endpoints/update-a-webhook-endpoint"},{"title":"Rotate a webhook endpoint's signing secret","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml post /api/v1/webhook-endpoints/{id}/rotate-secret","href":"/api/v1/reference/webhook-endpoints/rotate-a-webhook-endpoints-signing-secret"},{"title":"Send a test event to a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml post /api/v1/webhook-endpoints/{id}/test","href":"/api/v1/reference/webhook-endpoints/send-a-test-event-to-a-webhook-endpoint"},{"title":"List a webhook endpoint's deliveries","deprecated":null,"version":null,"openapi":"/openapi/platform-v1.yaml get /api/v1/webhook-endpoints/{id}/deliveries","href":"/api/v1/reference/webhook-endpoints/list-a-webhook-endpoints-deliveries"}]}]}]}]},{"language":"pt-BR","pages":[{"title":"pt-BR","href":"/platform/pt-BR/introduction"}]},{"language":"ko","pages":[{"title":"ko","href":"/platform/ko/introduction"}]},{"language":"ar","pages":[{"title":"ar","href":"/platform/ar/introduction"}]}]},"basePath":"","title":"Create a group mapping - CrewAI Platform","buildId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","deploymentId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C8RPHPxo.js","utils-0BK-9q6z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DfjzsUJT.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B4v9psJ4.js","snippetPresets-CpTQv-Ez.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BNP-Fvr0.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BSgu6h1D.js","shallow-Biv1i9Gs.js","getApiPlaygroundDisplay-BoGOXhtF.js","CodeSnippet-DvQoT18_.js","CodeSnippets-Dnpa15xT.js","Page-Buji1S4J.js","getPastedJson-xAIyhUFE.js","icon-S6FBih11.js","MethodPill-SaYeUZyk.js","DuplicateIcon-Cs-p3v2Q.js","createIcon-DjCFEoHq.js","DynamicMarkdown-BcnBltEQ.js","SectionHeading-BUBl0eEF.js","axios-vUo_bRtp.js","Markdown-h4cOoD8d.js","clsx-B2v50t8t.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DJnKvr0g.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BHrrjR1K.js"]}