Update labels for a group. The request body replaces the entire labels map stored for the group. Setting an empty object clears all labels. Requires an API key with manage permissions.
Update labels for a group. Labels are key-value pairs that can be used for organization and filtering. The request body replaces the entire labels map stored for the group, so sending an empty object clears all labels.
Use Get Group or List Groups to retrieve the current labels for a group before updating. You can also group usage by a label with group_by=group_label.<label_key> on Get Organization Usage.
Key-value pairs of labels. Replaces the entire labels map for the group. An empty object clears all labels.
Show child attributes
Example:
{ "department": "engineering" }
Response
Group labels updated successfully
Last modified on August 4, 2026
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Requesty Docs","description":"Documentation for Requesty, a unified LLM gateway and OpenAI-compatible API for 600+ AI models.","colors":{"primary":"#C8956A","light":"#D4A574","dark":"#E0B88A"},"logo":{"light":"https://mintcdn.com/requesty/o8v2COiz3OtlSbqG/logo/light.svg?fit=max\u0026auto=format\u0026n=o8v2COiz3OtlSbqG\u0026q=85\u0026s=33d22576c8ec4d1e68f24969181684df","dark":"https://mintcdn.com/requesty/o8v2COiz3OtlSbqG/logo/dark.svg?fit=max\u0026auto=format\u0026n=o8v2COiz3OtlSbqG\u0026q=85\u0026s=c21a835e0692187f8c47df7ab6528af9","href":"https://docs.requesty.ai"},"favicon":"https://mintcdn.com/requesty/MM5cSf0NbVkrpoDF/favicon.svg?fit=max\u0026auto=format\u0026n=MM5cSf0NbVkrpoDF\u0026q=85\u0026s=706185ad27099920b149c4ad2f15a5ca","api":{"openapi":["api-reference/requesty_inference-openapi.json","api-reference/requesty_management-openapi.json"],"playground":{}},"appearance":{"default":"dark"},"navbar":{"links":[{"href":"https://docs.requesty.ai/changelog","label":"Changelog"},{"href":"https://docs.requesty.ai/api-reference/requesty_openapi.json","label":"OpenAPI"},{"href":"https://discord.com/invite/Td3rwAHgt4","label":"Discord"}],"primary":{"type":"button","label":"Get Started","href":"https://app.requesty.ai/sign-up"}},"footer":{"socials":{"x":"https://x.com/requestyAI","linkedin":"https://linkedin.com/company/requesty"}},"search":{"prompt":"Search..."},"seo":{"metatags":{"og:site_name":"Requesty Docs"},"indexing":"navigable"},"fonts":{"heading":{"family":"Inter","weight":600},"body":{"family":"Inter"}},"styling":{"eyebrows":"breadcrumbs","codeblocks":"dark","latex":true},"integrations":{"amplitude":{"apiKey":"ce02ec2dce31d2745bd8a3ffaedd53cc"}},"contextual":{"options":["copy","chatgpt","claude","perplexity"],"display":"header"},"metadata":{"timestamp":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"requesty","hasAudioNarration":false,"actualSubdomain":"requesty","customDomains":["docs.requesty.ai"],"gitSource":{"type":"github","owner":"requestyai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af1ff26df3e9cabb27d07d7","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"default","tag":"Gateway","count":58},{"language":"default","tag":"Management API","count":37},{"language":"default","tag":"Integrations","count":27},{"language":"default","tag":"Inference API","count":21},{"language":"default","tag":"Inference APIs","count":21},{"language":"default","tag":"Organization","count":15},{"language":"default","tag":"LLM Gateway","count":14},{"language":"default","tag":"Analytics \u0026 Monitoring","count":12},{"language":"default","tag":"Coding Assistants","count":11},{"language":"default","tag":"API Keys","count":9}]},"assistantConfig":{"enableStarterQuestions":false,"deflection":{"enabled":true,"email":"[email protected]","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"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":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles/custom.css","content":":root{--requesty-gold: #C8956A;--requesty-gold-light: #E0B88A;--requesty-gold-muted: rgba(200, 149, 106, 0.15)}::-webkit-scrollbar{width:5px;height:5px}::-webkit-scrollbar-track{background:transparent}::-webkit-scrollbar-thumb{background:rgba(128, 128, 128, 0.15);border-radius:3px}::-webkit-scrollbar-thumb:hover{background:rgba(128, 128, 128, 0.3)}#navbar{backdrop-filter:blur(12px);-webkit-backdrop-filter:blur(12px)}img.nav-logo{height:2.25rem!important;max-width:18rem!important;max-height:2.25rem!important}#sidebar{font-size:13.5px!important}#sidebar-content{padding-top:0.5rem}sidebar-group-header{font-weight:600!important;letter-spacing:0.01em;text-transform:none!important}#content-area{max-width:100%}#page-title{font-size:2rem!important;font-weight:600!important;letter-spacing:-0.025em!important;line-height:1.2!important}mdx-content{font-size:15px!important;line-height:1.65!important}mdx-content h2{font-size:1.35rem!important;font-weight:600!important;letter-spacing:-0.015em!important;margin-top:2rem!important;margin-bottom:0.75rem!important}mdx-content h3{font-size:1.1rem!important;font-weight:600!important;margin-top:1.5rem!important;margin-bottom:0.4rem!important}mdx-content p{margin-top:0.6em!important;margin-bottom:0.6em!important}mdx-content li{margin-top:0.2rem!important;margin-bottom:0.2rem!important}code-block{border-radius:12px!important;overflow:hidden}mdx-content code:not(pre code){border:none!important;border-radius:5px!important;padding:2px 6px!important;font-size:0.9em!important}:root:not(.dark) mdx-content code:not(pre code){background:rgba(0, 0, 0, 0.05)!important}:root.dark mdx-content code:not(pre code){background:rgba(255, 255, 255, 0.08)!important}card{border-radius:12px!important;transition:border-color 0.2s ease, background-color 0.2s ease}:root:not(.dark) card{border:1px solid rgba(0, 0, 0, 0.08)!important}:root:not(.dark) card:hover{border-color:rgba(0, 0, 0, 0.15)!important;background:rgba(0, 0, 0, 0.01)!important}:root.dark card{border:1px solid rgba(255, 255, 255, 0.06)!important}:root.dark card:hover{border-color:rgba(255, 255, 255, 0.12)!important;background:rgba(255, 255, 255, 0.02)!important}callout{border-radius:10px!important;border-left-width:3px!important}mdx-content table{border-radius:10px!important;overflow:hidden}mdx-content table th{font-weight:600!important;font-size:0.85rem!important;letter-spacing:0.02em;text-transform:uppercase}mdx-content img{border-radius:10px!important}#request-example,#response-example{border-radius:12px!important;overflow:hidden}api-section{padding-bottom:2rem}:root:not(.dark) api-section{border-bottom:1px solid rgba(0, 0, 0, 0.06)}:root.dark api-section{border-bottom:1px solid rgba(255, 255, 255, 0.05)}api-section-heading-title{font-size:1.75rem!important;font-weight:600!important;letter-spacing:-0.02em!important}#table-of-contents{font-size:13px!important}toc-item{transition:color 0.15s ease}breadcrumb-list{font-size:13px!important;opacity:0.7}nav-tabs-item{font-weight:500!important;letter-spacing:0.01em}#pagination{margin-top:2rem!important;padding-top:1rem!important}:root:not(.dark) #pagination{border-top:1px solid rgba(0, 0, 0, 0.06)!important}:root.dark #pagination{border-top:1px solid rgba(255, 255, 255, 0.05)!important}accordion{border-radius:10px!important}steps{border-left-color:rgba(200, 149, 106, 0.3)!important}step-content{padding-bottom:0.75rem!important}expandable{border-radius:8px!important}#search-bar-entry{border-radius:8px!important}nav-tag-pill{font-size:11px!important;font-weight:600!important;letter-spacing:0.03em;border-radius:4px!important}[data-component-part=\"update-tag\"]{padding:2px 8px!important;border-radius:6px!important;font-size:12px!important}:root:not(.dark) [data-component-part=\"update-tag\"]{background:rgba(0, 0, 0, 0.06)!important;color:rgb(55, 65, 81)!important}:root.dark [data-component-part=\"update-tag\"]{background:rgba(255, 255, 255, 0.1)!important;color:rgb(209, 213, 219)!important}:root:not(.dark) #footer{border-top:1px solid rgba(0, 0, 0, 0.06)!important}:root.dark #footer{border-top:1px solid rgba(255, 255, 255, 0.05)!important}"}],"page":{"pagePath":"api-reference/endpoint/manage-group/manage-group-update-labels","slug":"/api-reference/endpoint/manage-group/manage-group-update-labels","pageMetadata":{"title":"Update Group Labels","openapi":"PATCH /v1/manage/group/{id}/label","description":"Update labels for a group. The request body replaces the entire `labels` map stored for the group. Setting an empty object clears all labels. Requires an API key with manage permissions.","href":"/api-reference/endpoint/manage-group/manage-group-update-labels"},"description":{"compiledSource":"\"use strict\";\nconst {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(_components.p, {\n children: [\"Update labels for a group. The request body replaces the entire \", _jsx(_components.code, {\n children: \"labels\"\n }), \" map stored for the group. Setting an empty object clears all labels. Requires an API key with manage permissions.\"]\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,..._provideComponents(),...props.components},{Note}=_components;if(!Note)_missingMdxReference(`Note`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Update labels for a group. Labels are key-value pairs that can be used for organization and filtering. The request body replaces the entire `,_jsx(_components.code,{children:`labels`}),` map stored for the group, so sending an empty object clears all labels.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Use `,_jsx(_components.a,{href:`/api-reference/endpoint/manage-group/manage-group-get`,children:`Get Group`}),` or `,_jsx(_components.a,{href:`/api-reference/endpoint/manage-group/manage-group-list`,children:`List Groups`}),` to retrieve the current labels for a group before updating. You can also group usage by a label with `,_jsx(_components.code,{children:`group_by=group_label.\u003clabel_key>`}),` on `,_jsx(_components.a,{href:`/api-reference/endpoint/manage-org-get-usage`,children:`Get Organization Usage`}),`.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":"dark","config":{},"pageMetadata":{"title":"Update Group Labels","openapi":"PATCH /v1/manage/group/{id}/label","description":"Update labels for a group. The request body replaces the entire `labels` map stored for the group. Setting an empty object clears all labels. Requires an API key with manage permissions.","href":"/api-reference/endpoint/manage-group/manage-group-update-labels"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Update group labels","description":"Update labels for a group. The request body replaces the entire `labels` map stored for the group. Setting an empty object clears all labels. Requires an API key with manage permissions.","parameters":["b601aeda-f86e-4f57-bf43-e7dbed294e14"],"requestBody":"b979afa8-e63e-4b7d-b305-6414860b607b","responses":{"200":"77dd4208-2ee3-4136-8382-cb4bbe495ca3","400":"19b5f141-b6d5-4e1c-aeed-f1d9d58650d0","401":"099e99bf-d206-4eeb-97d6-38684ee363c7","403":"7a56f1b0-1c47-4de1-a1ea-5677f742ffb2","404":"a851f8fa-5f02-4a15-a2a7-77cd9b3f884e","500":"6eb8cffd-ee4a-415c-9af4-cc88d2aba5ca"},"operationId":"updateGroupLabels","method":"patch","type":"path","servers":["44631049-0bad-4d37-9e0a-0e198eaf07eb"],"security":["d18b4fca-e73f-4a21-82bc-5902946d517e"],"path":"/v1/manage/group/{id}/label","baseUrlOptions":["https://api-v2.requesty.ai"],"title":"Update group labels","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"b601aeda-f86e-4f57-bf43-e7dbed294e14":{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"description":"The group ID","uniqueKey":"","typeLabel":"string\u003cuuid>"},"description":"The group ID","example":"123e4567-e89b-12d3-a456-426614174000"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["labels"],"properties":{"labels":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"labels.additionalProperties","typeLabel":"string"},"description":"Key-value pairs of labels. Replaces the entire labels map for the group. An empty object clears all labels.","example":{"department":"engineering"},"isRequired":true,"uniqueKey":"labels","typeLabel":"object"}},"example":{"labels":{"department":"engineering"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"labels":{"department":"engineering"}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"77dd4208-2ee3-4136-8382-cb4bbe495ca3":{"description":"Group labels updated successfully","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"19b5f141-b6d5-4e1c-aeed-f1d9d58650d0":{"description":"Bad request - invalid group ID or request body.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["origin","message"],"properties":{"origin":{"type":"string","enum":["router","provider"],"description":"Whether the error originated from Requesty's router or an upstream provider.","isRequired":true,"uniqueKey":"error.origin","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error description.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"origin":"router","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"099e99bf-d206-4eeb-97d6-38684ee363c7":{"description":"Unauthorized - missing or invalid Authorization header.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["origin","message"],"properties":{"origin":{"type":"string","enum":["router","provider"],"description":"Whether the error originated from Requesty's router or an upstream provider.","isRequired":true,"uniqueKey":"error.origin","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error description.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"origin":"router","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"7a56f1b0-1c47-4de1-a1ea-5677f742ffb2":{"description":"Forbidden - API key does not have manage permissions.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["origin","message"],"properties":{"origin":{"type":"string","enum":["router","provider"],"description":"Whether the error originated from Requesty's router or an upstream provider.","isRequired":true,"uniqueKey":"error.origin","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error description.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"origin":"router","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"a851f8fa-5f02-4a15-a2a7-77cd9b3f884e":{"description":"Not found - the group does not exist.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["origin","message"],"properties":{"origin":{"type":"string","enum":["router","provider"],"description":"Whether the error originated from Requesty's router or an upstream provider.","isRequired":true,"uniqueKey":"error.origin","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error description.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"origin":"router","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"6eb8cffd-ee4a-415c-9af4-cc88d2aba5ca":{"description":"Internal server error.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["origin","message"],"properties":{"origin":{"type":"string","enum":["router","provider"],"description":"Whether the error originated from Requesty's router or an upstream provider.","isRequired":true,"uniqueKey":"error.origin","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error description.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"origin":"router","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"d18b4fca-e73f-4a21-82bc-5902946d517e":{"BearerAuth":{"type":"http","scheme":"bearer","description":"API key for authentication","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"44631049-0bad-4d37-9e0a-0e198eaf07eb":{"url":"https://api-v2.requesty.ai","description":"Management API endpoint"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"API key for authentication","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key for authentication","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"api-reference/requesty_management-openapi.json"},"subdomain":"requesty","siteName":"Requesty Docs","title":"Update Group Labels - Requesty Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-04T08:25:16.776Z","gitLastModified":"2026-08-04T08:24:46.000Z","originalFileLocation":"api-reference/endpoint/manage-group/manage-group-update-labels.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}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=\"Update labels for a group. The request body replaces the entire labels map stored for the group. Setting an empty object clears all labels. Requires an API key with manage permissions.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Requesty Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/requesty/bWQG6e3TK2khNMP8/_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/requesty/bWQG6e3TK2khNMP8/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/requesty/bWQG6e3TK2khNMP8/_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/requesty/bWQG6e3TK2khNMP8/_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/requesty/bWQG6e3TK2khNMP8/_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/requesty/bWQG6e3TK2khNMP8/_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/requesty/bWQG6e3TK2khNMP8/_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/requesty/bWQG6e3TK2khNMP8/_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/requesty/bWQG6e3TK2khNMP8/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Update Group Labels - Requesty Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Update labels for a group. The request body replaces the entire labels map stored for the group. Setting an empty object clears all labels. Requires an API key with manage permissions.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Requesty Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.requesty.ai/api-reference/endpoint/manage-group/manage-group-update-labels\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://requesty.mintlify.site/_mintlify/api/og/v2?division=Groups\u0026amp;title=Update+Group+Labels\u0026amp;description=Update+labels+for+a+group.+The+request+body+replaces+the+entire+%60labels%60+map+stored+for+the+group.+Setting+an+empty+object+clears+all+labels.+Requires+an+API+ke\u0026amp;theme=a48e85110015de94690ebb47\u0026amp;signature=d9bf9e446f1a9aa9a6ac68c559dfb8eebe52364f4a9982570670bf79ea42d6ec\">\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=\"Update Group Labels - Requesty Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Update labels for a group. The request body replaces the entire labels map stored for the group. Setting an empty object clears all labels. Requires an API key with manage permissions.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://requesty.mintlify.site/_mintlify/api/og/v2?division=Groups\u0026amp;title=Update+Group+Labels\u0026amp;description=Update+labels+for+a+group.+The+request+body+replaces+the+entire+%60labels%60+map+stored+for+the+group.+Setting+an+empty+object+clears+all+labels.+Requires+an+API+ke\u0026amp;theme=a48e85110015de94690ebb47\u0026amp;signature=d9bf9e446f1a9aa9a6ac68c559dfb8eebe52364f4a9982570670bf79ea42d6ec\">\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/requesty/bWQG6e3TK2khNMP8/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Requesty Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#C8956A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.requesty.ai/api-reference/endpoint/manage-group/manage-group-update-labels\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoint/manage-group/manage-group-update-labels.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.requesty.ai/#organization\",\"name\":\"Requesty Docs\",\"url\":\"https://docs.requesty.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/requesty/o8v2COiz3OtlSbqG/logo/light.svg?fit=max\u0026auto=format\u0026n=o8v2COiz3OtlSbqG\u0026q=85\u0026s=33d22576c8ec4d1e68f24969181684df\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.requesty.ai#website\",\"name\":\"Requesty Docs\",\"url\":\"https://docs.requesty.ai\",\"publisher\":{\"@id\":\"https://docs.requesty.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.requesty.ai/api-reference/endpoint/manage-group/manage-group-update-labels#webpage\",\"url\":\"https://docs.requesty.ai/api-reference/endpoint/manage-group/manage-group-update-labels\",\"name\":\"Update Group Labels\",\"description\":\"Update labels for a group. The request body replaces the entire labels map stored for the group. Setting an empty object clears all labels. Requires an API key with manage permissions.\",\"dateModified\":\"2026-08-04T08:24:46.000Z\",\"isPartOf\":{\"@id\":\"https://docs.requesty.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.requesty.ai/api-reference/endpoint/manage-group/manage-group-update-labels#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.requesty.ai/api-reference/endpoint/manage-group/manage-group-update-labels#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Groups\",\"item\":\"https://docs.requesty.ai/api-reference/endpoint/manage-group/manage-group-list\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Update Group Labels\",\"item\":\"https://docs.requesty.ai/api-reference/endpoint/manage-group/manage-group-update-labels\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.requesty.ai/api-reference/endpoint/manage-group/manage-group-update-labels#apireference\",\"headline\":\"Update Group Labels\",\"name\":\"Update Group Labels\",\"description\":\"Update labels for a group. The request body replaces the entire labels map stored for the group. Setting an empty object clears all labels. Requires an API key with manage permissions.\",\"url\":\"https://docs.requesty.ai/api-reference/endpoint/manage-group/manage-group-update-labels\",\"mainEntityOfPage\":{\"@id\":\"https://docs.requesty.ai/api-reference/endpoint/manage-group/manage-group-update-labels#webpage\"},\"dateModified\":\"2026-08-04T08:24:46.000Z\",\"publisher\":{\"@id\":\"https://docs.requesty.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.requesty.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Requesty Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Requesty Docs","nav":{"global":null,"tabs":[{"tab":"Gateway","pages":[{"title":"Gateway","href":"/quickstart"}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations/requesty-cli"}]},{"tab":"Inference API","pages":[{"title":"Inference API","href":"/api-reference/inference-apis"}]},{"tab":"Management API","groups":[{"group":"API Keys","pages":[{"title":"Overview","href":"/api-reference/management-apis"},{"title":"List API Keys","openapi":"GET /v1/manage/apikey","href":"/api-reference/endpoint/manage-apikey/manage-api-key-list"},{"title":"Get API Key","openapi":"GET /v1/manage/apikey/{id}","href":"/api-reference/endpoint/manage-apikey/manage-api-key-get"},{"title":"Get API Key Usage","openapi":"GET /v1/manage/apikey/{id}/usage","href":"/api-reference/endpoint/manage-apikey/manage-api-key-get-usage"},{"title":"Create API Key","openapi":"POST /v1/manage/apikey","href":"/api-reference/endpoint/manage-apikey/manage-api-key-create"},{"title":"Update API Key Limit","openapi":"POST /v1/manage/apikey/{id}/limit","href":"/api-reference/endpoint/manage-apikey/manage-api-key-update-limit"},{"title":"Update API Key Labels","openapi":"POST /v1/manage/apikey/{id}/label","href":"/api-reference/endpoint/manage-apikey/manage-api-key-update-label"},{"title":"Update API Key Expiry","openapi":"POST /v1/manage/apikey/{id}/expiry","href":"/api-reference/endpoint/manage-apikey/manage-api-key-update-expiry"},{"title":"Delete API Key","openapi":"DELETE /v1/manage/apikey/{id}","href":"/api-reference/endpoint/manage-apikey/manage-api-key-delete"}]},{"group":"Groups","pages":[{"title":"List Groups","openapi":"GET /v1/manage/group","href":"/api-reference/endpoint/manage-group/manage-group-list"},{"title":"Create Group","openapi":"POST /v1/manage/group","href":"/api-reference/endpoint/manage-group/manage-group-create"},{"title":"Get Group","openapi":"GET /v1/manage/group/{id}","href":"/api-reference/endpoint/manage-group/manage-group-get"},{"title":"Delete Group","openapi":"DELETE /v1/manage/group/{id}","href":"/api-reference/endpoint/manage-group/manage-group-delete"},{"title":"Update Group Budget","openapi":"PATCH /v1/manage/group/{id}/budget","href":"/api-reference/endpoint/manage-group/manage-group-update-budget"},{"title":"Update Group Per-User Budget","openapi":"PATCH /v1/manage/group/{id}/budget-per-user","description":"Set the monthly budget applied to each user in the group. Set `monthly_budget_per_user` to `0` for unlimited spending per user. Only available when the organization uses group budgets (group budget mode); otherwise the endpoint returns `409`. Requires an API key with manage permissions.","href":"/api-reference/endpoint/manage-group/manage-group-update-budget-per-user"},{"title":"Update Group Labels","openapi":"PATCH /v1/manage/group/{id}/label","href":"/api-reference/endpoint/manage-group/manage-group-update-labels"}]},{"group":"Group Members","pages":[{"title":"Add Group Member","openapi":"POST /v1/manage/group/{id}/member","description":"Add a member to a group in your organization. The member will be assigned the specified role.","href":"/api-reference/endpoint/manage-group-member/manage-group-member-add"},{"title":"Update Group Member Role","openapi":"PUT /v1/manage/group/{group_id}/member/{member_id}/role","href":"/api-reference/endpoint/manage-group-member/manage-group-member-update"},{"title":"Update Group Member Budget Override","openapi":"PUT /v1/manage/group/{group_id}/member/{member_id}/budget-override","href":"/api-reference/endpoint/manage-group-member/manage-group-member-budget-override"},{"title":"Remove Group Member","openapi":"DELETE /v1/manage/group/{id}/member","href":"/api-reference/endpoint/manage-group-member/manage-group-member-remove"}]},{"group":"Approved Models","pages":[{"title":"Get Org Approved Models","openapi":"GET /v1/manage/org/approved-model","href":"/api-reference/endpoint/manage-approved-model/manage-approved-model-get"},{"title":"Set Org Approved Models","openapi":"POST /v1/manage/org/approved-model","href":"/api-reference/endpoint/manage-approved-model/manage-approved-model-set"}]},{"group":"Access Lists","pages":[{"title":"List Access Lists","openapi":"GET /v1/manage/access-list","href":"/api-reference/endpoint/manage-access-list/manage-access-list-list"},{"title":"Create Access List","openapi":"POST /v1/manage/access-list","href":"/api-reference/endpoint/manage-access-list/manage-access-list-create"},{"title":"Get Access List","openapi":"GET /v1/manage/access-list/{access_list_id}","href":"/api-reference/endpoint/manage-access-list/manage-access-list-get"},{"title":"Update Access List","openapi":"PATCH /v1/manage/access-list/{access_list_id}","href":"/api-reference/endpoint/manage-access-list/manage-access-list-update"},{"title":"Delete Access List","openapi":"DELETE /v1/manage/access-list/{access_list_id}","href":"/api-reference/endpoint/manage-access-list/manage-access-list-delete"},{"title":"Set Default Group Access List","openapi":"POST /v1/manage/org/group/access-list","href":"/api-reference/endpoint/manage-access-list/manage-access-list-set-group-default"}]},{"group":"Routing Policies","pages":[{"title":"List Policies","openapi":"GET /v1/manage/policy","href":"/api-reference/endpoint/manage-policy/manage-policy-list"},{"title":"Create Policy","openapi":"POST /v1/manage/policy","href":"/api-reference/endpoint/manage-policy/manage-policy-create"},{"title":"Update Policy","openapi":"PATCH /v1/manage/policy/{policy_id}","href":"/api-reference/endpoint/manage-policy/manage-policy-update"},{"title":"Delete Policy","openapi":"DELETE /v1/manage/policy/{policy_id}","href":"/api-reference/endpoint/manage-policy/manage-policy-delete"}]},{"group":"Organization","pages":[{"title":"Get Organization","openapi":"GET /v1/manage/org","href":"/api-reference/endpoint/manage-org-get"},{"title":"List Organization Members","openapi":"GET /v1/manage/org/member","href":"/api-reference/endpoint/manage-org-member-list"},{"title":"Delete Organization Member","openapi":"DELETE /v1/manage/org/member/{user_id}","href":"/api-reference/endpoint/manage-org-member-delete"},{"title":"Get Organization Usage","openapi":"GET /v1/manage/org/usage","href":"/api-reference/endpoint/manage-org-get-usage"}]},{"group":"Resources","pages":[{"title":"OpenAPI Spec","icon":"download","href":"/api-reference/openapi-management-spec"}]}]}]},"basePath":"","title":"Update Group Labels - Requesty Docs","buildId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","deploymentId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C-hEh3I2.js","utils-CnF4QiUD.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C7PVNbel.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-8ytevL2A.js","snippetPresets-BT1alx3v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BLXC0i_W.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CyLIGI9_.js","shallow-DC0lGVIW.js","getApiPlaygroundDisplay-CgDQ85tN.js","CodeSnippet-6-I-Gpv9.js","CodeSnippets-BAk1kDdu.js","Page-C945cI-W.js","getPastedJson-B276RuWN.js","icon-BqP8etTm.js","MethodPill-DM6sbxG1.js","DuplicateIcon-PyJglOaE.js","createIcon-CMeOMAc_.js","DynamicMarkdown-BoyYAA8K.js","SectionHeading-DAYv3gvZ.js","axios-vUo_bRtp.js","Markdown-BhTTmazV.js","clsx-CR-RHrVC.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CBUH0-zX.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BmARFYNC.js"]}