{
"errors": [
{
"type": "https://docs-platform.crewai.com/api/problems/forbidden",
"code": "forbidden",
"title": "Forbidden",
"status": 403,
"detail": "Teams are not available for your organization."
}
]
}
{
"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."
}
]
}
{
"errors": [
{
"type": "https://docs-platform.crewai.com/api/problems/validation_error",
"code": "validation_error",
"title": "Validation error",
"status": 422,
"detail": "The specified role is invalid."
}
]
}
Teams
Assign a role to a team
Grants a role to a customer-owned team, scoped to a single record or to the whole
organization. CrewAI-managed teams reject a role change.
The authenticated service account must hold the
organizations:manage_identity_and_access permission. Without it the request
is forbidden, whether or not the requested team exists.
{
"errors": [
{
"type": "https://docs-platform.crewai.com/api/problems/forbidden",
"code": "forbidden",
"title": "Forbidden",
"status": 403,
"detail": "Teams are not available for your organization."
}
]
}
{
"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."
}
]
}
{
"errors": [
{
"type": "https://docs-platform.crewai.com/api/problems/validation_error",
"code": "validation_error",
"title": "Validation error",
"status": 422,
"detail": "The specified role is invalid."
}
]
}
{"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":"54c3a7a9-74cf-43ee-a388-9b7727e99df5","liveDeploymentHistoryId":"6ae177788136a9fcca26999e","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae177788136a9fcca26999e"},"entitlements":{},"buildId":"6ae177788136a9fcca26999e","clientVersion":"0.0.4006","searchFilterCounts":[{"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":"API Reference","count":61},{"language":"en","tag":"Platform API reference","count":51},{"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":"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":"en","tag":"Build","count":9},{"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":"editor-v7-file-tree","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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"editor-agent-model-picker","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api/v1/reference/teams/assign-a-role-to-a-team","slug":"/api/v1/reference/teams/assign-a-role-to-a-team","pageMetadata":{"title":"Assign a role to a team","description":"Grants a role to a customer-owned team, scoped to a single record or to the whole\norganization. CrewAI-managed teams reject a role change.\n\nThe authenticated service account must hold the\n`organizations:manage_identity_and_access` permission. Without it the request\nis forbidden, whether or not the requested team exists.\n","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","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Grants a role to a customer-owned team, scoped to a single record or to the whole\\norganization. CrewAI-managed teams reject a role change.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"The authenticated service account must hold the\\n\", _jsx(_components.code, {\n children: \"organizations:manage_identity_and_access\"\n }), \" permission. Without it the request\\nis forbidden, whether or not the requested team exists.\"]\n })]\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":"Assign a role to a team","description":"Grants a role to a customer-owned team, scoped to a single record or to the whole\norganization. CrewAI-managed teams reject a role change.\n\nThe authenticated service account must hold the\n`organizations:manage_identity_and_access` permission. Without it the request\nis forbidden, whether or not the requested team exists.\n","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","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Assign a role to a team","operationId":"createTeamGrantedRole","description":"Grants a role to a customer-owned team, scoped to a single record or to the whole\norganization. CrewAI-managed teams reject a role change.\n\nThe authenticated service account must hold the\n`organizations:manage_identity_and_access` permission. Without it the request\nis forbidden, whether or not the requested team exists.\n","tags":["Teams"],"parameters":[],"responses":{"201":"a8ecdfbe-e9e8-4a32-aaca-8ee3996dd23a","400":"a7555971-ba53-4fd2-a3da-5b902a7c08b5","401":"cef4eaa1-26b3-4c3c-922c-cf5ce4906c1f","403":"a0d45c86-8c5e-4447-9e1c-4f4f0c3c6d9b","404":"0cce4606-29bf-4055-bdda-9f6aadb7424c","422":"872a8dc6-2ce9-40f2-a7c0-9133a5eba476"},"requestBody":"d4e3ca4e-f7e3-43ba-a05e-04985215ad03","method":"post","type":"path","servers":["d3c2a95c-0595-4017-8b23-b21533a9d714"],"security":["eb6955bd-7909-4f4d-b419-9b151c33652d"],"path":"/api/v1/teams/{team_id}/granted-roles","baseUrlOptions":["https://app.crewai.com"],"title":"Assign a role to a team","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"c3c70fcd-e831-4053-b3f6-79a39fd5fcfe":{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","example":"4f6d0d9a-7b78-4c6a-b64f-2e2e3d2c8f9a","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"role_id":{"type":"string","format":"uuid","example":"4f6d0d9a-7b78-4c6a-b64f-2e2e3d2c8f9a","isRequired":true,"uniqueKey":"role_id","typeLabel":"string\u003cuuid>"},"scope":{"type":"object","required":["type","id"],"additionalProperties":false,"properties":{"type":{"type":"string","example":"Organization","enum":["Organization","Automation","Policy","LLMConnection","Team","Agent","EnvironmentVariable","GitRepository","Skill","Tool","ApplicationConnection","StudioProject"],"x-crewai-enum-format":"freeform","isRequired":true,"uniqueKey":"scope.type","typeLabel":"enum\u003cstring>"},"id":{"type":"string","format":"uuid","example":"4f6d0d9a-7b78-4c6a-b64f-2e2e3d2c8f9a","isRequired":true,"uniqueKey":"scope.id","typeLabel":"string\u003cuuid>"}},"isRequired":true,"uniqueKey":"scope","typeLabel":"object"}},"required":["role_id","scope"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"role_id":"4f6d0d9a-7b78-4c6a-b64f-2e2e3d2c8f9a","scope":{"type":"Organization","id":"4f6d0d9a-7b78-4c6a-b64f-2e2e3d2c8f9a"}}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"a8ecdfbe-e9e8-4a32-aaca-8ee3996dd23a":{"description":"Created","content":{"application/json":{"examples":{"created":{"title":"created","value":{"data":{"id":"4f6d0d9a-7b78-4c6a-b64f-2e2e3d2c8f9a","role":{"id":"4f6d0d9a-7b78-4c6a-b64f-2e2e3d2c8f9a","name":"Automation Reader","created_at":"2026-07-07T00:00:00Z","updated_at":"2026-07-07T00:00:00Z"},"scope":{"type":"Automation","id":"17790c04-15ee-47b1-bac3-cbee04bb0708"},"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","role","scope","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>"},"role":{"type":"object","additionalProperties":false,"required":["id","name","created_at","updated_at"],"properties":{"id":{"type":"string","format":"uuid","example":"4f6d0d9a-7b78-4c6a-b64f-2e2e3d2c8f9a","isRequired":true,"uniqueKey":"data.role.id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","example":"Automation Reader","isRequired":true,"uniqueKey":"data.role.name","typeLabel":"string"},"created_at":{"type":"string","format":"date-time","example":"2026-07-07T00:00:00Z","isRequired":true,"uniqueKey":"data.role.created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","example":"2026-07-07T00:00:00Z","isRequired":true,"uniqueKey":"data.role.updated_at","typeLabel":"string\u003cdate-time>"}},"isRequired":true,"uniqueKey":"data.role","typeLabel":"object"},"scope":{"type":"object","required":["type","id"],"additionalProperties":false,"properties":{"type":{"type":"string","example":"Organization","enum":["Organization","Automation","Policy","LLMConnection","Team","Agent","EnvironmentVariable","GitRepository","Skill","Tool","ApplicationConnection","StudioProject"],"x-crewai-enum-format":"freeform","isRequired":true,"uniqueKey":"data.scope.type","typeLabel":"enum\u003cstring>"},"id":{"type":"string","format":"uuid","example":"4f6d0d9a-7b78-4c6a-b64f-2e2e3d2c8f9a","isRequired":true,"uniqueKey":"data.scope.id","typeLabel":"string\u003cuuid>"}},"isRequired":true,"uniqueKey":"data.scope","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"},"a7555971-ba53-4fd2-a3da-5b902a7c08b5":{"description":"Bad Request","content":{"application/json":{"examples":{"missing_role_id":{"title":"missing_role_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."}]}}},"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"},"cef4eaa1-26b3-4c3c-922c-cf5ce4906c1f":{"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"},"a0d45c86-8c5e-4447-9e1c-4f4f0c3c6d9b":{"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"},"0cce4606-29bf-4055-bdda-9f6aadb7424c":{"description":"Not Found","content":{"application/json":{"examples":{"not_found":{"title":"not_found","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"},"872a8dc6-2ce9-40f2-a7c0-9133a5eba476":{"description":"Unprocessable Content","content":{"application/json":{"examples":{"unknown_role":{"title":"unknown_role","value":{"errors":[{"type":"https://docs-platform.crewai.com/api/problems/validation_error","code":"validation_error","title":"Validation error","status":422,"detail":"The specified role 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"}},"security":{"eb6955bd-7909-4f4d-b419-9b151c33652d":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"opaque","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"d3c2a95c-0595-4017-8b23-b21533a9d714":{"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":"Assign a role to a team - CrewAI Platform","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api/v1/reference/teams/assign-a-role-to-a-team","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-10-27T22:42:43.305Z","originalFileLocation":"api/v1/reference/teams/assign-a-role-to-a-team.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=\"Grants a role to a customer-owned team, scoped to a single record or to the whole organization. CrewAI-managed teams reject a role change. The authenticated service account must hold the organizations:manage_identity_and_access permission. Without it the request is forbidden, whether or not the requested team exists.\">\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=\"Assign a role to a team - CrewAI Platform\">\u003cmeta data-mint-head property=\"og:description\" content=\"Grants a role to a customer-owned team, scoped to a single record or to the whole organization. CrewAI-managed teams reject a role change. The authenticated service account must hold the organizations:manage_identity_and_access permission. Without it the request is forbidden, whether or not the requested team exists.\">\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/teams/assign-a-role-to-a-team\">\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=\"Assign a role to a team - CrewAI Platform\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Grants a role to a customer-owned team, scoped to a single record or to the whole organization. CrewAI-managed teams reject a role change. The authenticated service account must hold the organizations:manage_identity_and_access permission. Without it the request is forbidden, whether or not the requested team exists.\">\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/teams/assign-a-role-to-a-team\">\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/teams/assign-a-role-to-a-team.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/teams/assign-a-role-to-a-team#webpage\",\"url\":\"https://docs-platform.crewai.com/api/v1/reference/teams/assign-a-role-to-a-team\",\"name\":\"Assign a role to a team\",\"description\":\"Grants a role to a customer-owned team, scoped to a single record or to the whole organization. CrewAI-managed teams reject a role change. The authenticated service account must hold the organizations:manage_identity_and_access permission. Without it the request is forbidden, whether or not the requested team exists.\",\"dateModified\":\"2026-10-27T22:42:43.305Z\",\"isPartOf\":{\"@id\":\"https://docs-platform.crewai.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs-platform.crewai.com/api/v1/reference/teams/assign-a-role-to-a-team#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs-platform.crewai.com/api/v1/reference/teams/assign-a-role-to-a-team#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Platform API reference\",\"item\":\"https://docs-platform.crewai.com/api/v1/reference/automations/list-an-automations-executions\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Teams\",\"item\":\"https://docs-platform.crewai.com/api/v1/reference/teams/request-a-team-membership-source-purge\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Assign a role to a team\",\"item\":\"https://docs-platform.crewai.com/api/v1/reference/teams/assign-a-role-to-a-team\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs-platform.crewai.com/api/v1/reference/teams/assign-a-role-to-a-team#apireference\",\"headline\":\"Assign a role to a team\",\"name\":\"Assign a role to a team\",\"description\":\"Grants a role to a customer-owned team, scoped to a single record or to the whole organization. CrewAI-managed teams reject a role change. The authenticated service account must hold the organizations:manage_identity_and_access permission. Without it the request is forbidden, whether or not the requested team exists.\",\"url\":\"https://docs-platform.crewai.com/api/v1/reference/teams/assign-a-role-to-a-team\",\"mainEntityOfPage\":{\"@id\":\"https://docs-platform.crewai.com/api/v1/reference/teams/assign-a-role-to-a-team#webpage\"},\"image\":\"https://docs.crewai.com/images/crew_only_logo.png\",\"dateModified\":\"2026-10-27T22:42:43.305Z\",\"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":"Automations","pages":[{"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":"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"}]},{"group":"Group Mappings","pages":[{"title":"List group mappings","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","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","description":"Returns roles granted to a team in the organization associated with the\nauthenticated service account.\n\nThe authenticated service account must hold the\n`organizations:manage_identity_and_access` permission. Without it the request\nis forbidden, whether or not the requested team exists.\n","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","description":"Revokes an active role granted to a customer-owned team in the organization\nassociated with the authenticated service account. CrewAI-managed teams reject a\nrole change. The granted role stays in the platform for audit purposes, so this\ndoes not delete it. Later requests for it return not found.\n\nThe authenticated service account must hold the\n`organizations:manage_identity_and_access` permission. Without it the request\nis forbidden, whether or not the requested team exists.\n","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":"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":"Studio Projects","pages":[{"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":"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"}]}]},"title":"Assign a role to a team - CrewAI Platform","buildId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","deploymentId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DmVyH30O.js","utils-BHQqGGOd.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CD-E4BIt.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp5Lq9Ds.js","snippetPresets-C4xAVCFP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CgXVLxUC.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BF8I5oUf.js","shallow-Byd0lWnC.js","getApiPlaygroundDisplay-BGOZG1OK.js","CodeSnippet-CpvQL0CY.js","CodeSnippets-B8wkBKXa.js","Page-CBCH2P7b.js","getPastedJson-Ry3scI3Y.js","icon-D7a9HcdD.js","MethodPill-CJ8pmHhz.js","DuplicateIcon-rh1HJF0t.js","createIcon-DvGznqYs.js","DynamicMarkdown-Cc6AuSHS.js","SectionHeading-B4A0S-ep.js","axios-vUo_bRtp.js","Markdown-Cc16CX65.js","clsx-Cs6nMGht.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-zbf22OZA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-C_fs-y5n.js"]}