---
id: rbac-permissions-assigned-by-roles-unassign-partial-update
title: "rbac_permissions_assigned_by_roles_unassign_partial_update"
description: "Unassign permission(s) to role. When `object_pk` is set, the permissions"
sidebar_label: "rbac_permissions_assigned_by_roles_unassign_partial_update"
hide_title: true
hide_table_of_contents: true
api: eJzNWF9v2zYQ/yqCnlbAo9K0D0OelnXBFqAdgrTZHrrApaSzzZoiNZJKIhj+7rsjJUvyH1kd+rAHUeTxd8fj8UgebxPrEgx3QqvbPL6KTcqzOVIKYS3S7Jzjf6kgn6f13GgJdl6pQJuX3DjB5bwqc+4gnsU52MyIkoShqIcGF3XifrCvIqcjksOiv1agoi86/QqZm5frL5GwkQU3i9wKejz2b8UNRFrJOmqVISGEsiVkYiGyKEiZRRqp5llYoG7EI+OOZyl1yqWsGWqKqvMCHBgbX33exIL0LblbYZfCDmxVlcixZbMVFDy+2sSuLolunRFqiT0LbQruWuR2f/bX0cPD7a9RgEciB+XEoqa6W+FE78kEKMXAP5UwgKZ3poLt4yx2fElK+ZWIHwMCrPtF5zWpkWnlUBZVeVlKkfm1S75aGnVzqG+wzMHi3AepZMhmlXik4Llnd7KSIedwAiwJ7C1JTz43hteIFQ4Ke8xOhVDvQS3Rtlevt2imQucgCQiqKmiivMK1Quus5zgxrpxluS64IAW6rszUpdMsI3UWNGlYQ11yYQaohdTPllF5gmzRupAKlQfdOoiuXKmtHztbo1uAeRIZoLEVWi9Y4wh4XaVgFPqRncjQVAadpcZVRBvP86ooauZLT6uPw+AJCXP0PVxqw3yraYxyvZTC1KzE1X7WJg/NMwwG/HKzrjrGsAQtSubLMVirwU6VMbCBsnLew1lXHWFgoe/YCqMzP+E2NHYuc14yKlrSCZwm4iWzGe6CAtGnJTbI8DsjFWsvuA5UnkEanovKsvD7L9hm/9bjylteSEbFmSH6uCliM1EwKs6JbXHHxNEhyOi6GFCtrkwGvYUMhCmYMd1bFr+MYTFHBB+gpouu8LToMZ44NIY8S6OrcjpTKeGFUTEygz3MFP09C6nfsU1RxCs/mWXnaCO672Gm6O5ZSPeObYoiXvfpLK03j+k+xIzqTvcVBmENAe89bfCe0GxAQYIHTmPFLwe6rM7DbWGHIyFh4kjEit/kkehoz/YG87Sp4wUB4Td1VKddORyTKBNH9MxUTB3tiUtBkfJwxJY6cdRnSImghkJa6rcKaSunp5DxEmMLzpr/yQFwX1gksOZ/Fkcbsakfg2G8jKEQFicF9aKlkxi8toVkvjyJaULzJpBmw+ZpLvUkmsCkq34b+hjwIDg6KRJPjaJ0LPzOAk6KoWVAY0uMYf2ShOo4XOqlUB7ta2fBGPS2aKyOw5+NaDTxtUNwarjKLfO/YYes8CgV9H7YVb1yas+xM20gnOqHZBr4kNp7aB12Or2GIRlLir3wFcqQDdDHT4Q+S62XEua4zmtb8gy18oRd+0zkNJV9PE4rRGa01QtHehvOdm3fPKPCNOZxBQyFeDw7G+BmDBQ+FsTegXFM0Ln7NFy8rLmQD3zMv6lseFod61C6OyFwmsqWeHGcA57rN5U8qkUfg8f1Sut1OzPKFuy9tp1wkggf6JV9Qy9sfHLvcixT3uethDv/pszvdq/+a58naBIH8XZLYAtZhfu09lmUnerYetz61AVaBt3f5wUuL97Sb5iG+FhluAB2UUlZR21iCXw65e3FxXfMd/wZbllsRDfGaHOQ3VBazRcCZD4H6v+GFAfZIUNzH+/heS5oWC7v+uP1DN2pFjTzhh1qH+zx5jva4zdQYEQWXd/dnjBIDg6vzSOTGpttl8763Ap47GbaDDoyTcoPgVvpPOTjspXP1ZFvxgm9BZNeEio5SE0mG8rFbZPWkRJK4IF5atN8lZEkiJcieXqTxOSirQN/JLuFiffceDfFlXNlmw2kdgrcgPH6kuXvuxzdzQsvSgkHCbPPrZkedymwscxXb8v2DC/UQnutGoN2qs5immUw4+XF5Vv2E3t9sOgf+JoSkL1YkPaDFaQwJSPJt3jmfcvHTDRxkFL/vNS7kZjQpEl7sdHOCQnTD7efUEQwMZnLXiXJUrhVlWJMWCQ9EUlXS6VOE5py8v723c0fH2+8SSlFVnDVE05r388Jd1ndtPbpZLs7PaImLR0dT0v3dtD/OkPdOJ6DF5eUkpxi21h30+yIJkU8G/gZHjj7uwJpV002u7URVskPV5SKRDmbTcotPBi53RIZfdnQiY7VJ24ET8nXcPvkwlId9+aCSwsjhv3hvjkHXkUT8+BHp9uev4pOX3wnVdTC6hrqXd79EXEr4BQ4kI6h613Q5MdPJKBjPTgwt7OW4xrvIR9Hn8Y+9s6mu+tP735HdNpk5Qt/IsaGU+KZSq+n9qbxh4qnbWLJ1bKicOMqDkL9FVHRcu7OmuZsmbUVmtZRS+CyecQnikBx6VrDhIgULbPd/gtjtcS/
sidebar_class_name: "patch api-method"
info_path: docs/developer-docs/api/reference/authentik
custom_edit_url: null
hide_send_button: true
---

import ApiTabs from "@theme/ApiTabs";
import DiscriminatorTabs from "@theme/DiscriminatorTabs";
import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import SecuritySchemes from "@theme/ApiExplorer/SecuritySchemes";
import MimeTabs from "@theme/MimeTabs";
import ParamsItem from "@theme/ParamsItem";
import ResponseSamples from "@theme/ResponseSamples";
import SchemaItem from "@theme/SchemaItem";
import SchemaTabs from "@theme/SchemaTabs";
import Markdown from "@theme/Markdown";
import Heading from "@theme/Heading";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"rbac_permissions_assigned_by_roles_unassign_partial_update"}
>
</Heading>

<MethodEndpoint
  method={"patch"}
  path={"/rbac/permissions/assigned_by_roles/{uuid}/unassign/"}
>
  
</MethodEndpoint>



Unassign permission(s) to role. When `object_pk` is set, the permissions
are only assigned to the specific object, otherwise they are assigned globally.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<details
  style={{"marginBottom":"1rem"}}
  className={"openapi-markdown__details"}
  data-collapsed={false}
  open={true}
>
  <summary
    style={{}}
  >
    <h3
      className={"openapi-markdown__details-summary-header-params"}
    >
      Path Parameters
    </h3>
  </summary><div>
    <ul>
      <ParamsItem
        className={"paramsItem"}
        param={{"in":"path","name":"uuid","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this Role.","required":true}}
      >
        
      </ParamsItem>
    </ul>
  </div>
</details><MimeTabs
  className={"openapi-tabs__mime"}
>
  <TabItem
    label={"application/json"}
    value={"application/json-schema"}
  >
    <details
      style={{}}
      className={"openapi-markdown__details mime"}
      data-collapsed={false}
      open={true}
    >
      <summary
        style={{}}
        className={"openapi-markdown__details-summary-mime"}
      >
        <h3
          className={"openapi-markdown__details-summary-header-body"}
        >
          Body
        </h3>
      </summary><div
        style={{"textAlign":"left","marginLeft":"1rem"}}
      >
        
      </div><ul
        style={{"marginLeft":"1rem"}}
      >
        <SchemaItem
          collapsible={false}
          name={"permissions"}
          required={false}
          schemaName={"string[]"}
          qualifierMessage={"**Possible values:** `non-empty`"}
          schema={{"type":"array","items":{"type":"string","minLength":1}}}
        >
          
        </SchemaItem><SchemaItem
          collapsible={false}
          name={"model"}
          required={false}
          schemaName={"ModelEnum (string)"}
          qualifierMessage={"**Possible values:** [`authentik_tenants.domain`, `authentik_crypto.certificatekeypair`, `authentik_flows.flow`, `authentik_flows.flowstagebinding`, `authentik_outposts.dockerserviceconnection`, `authentik_outposts.kubernetesserviceconnection`, `authentik_outposts.outpost`, `authentik_policies_dummy.dummypolicy`, `authentik_policies_event_matcher.eventmatcherpolicy`, `authentik_policies_expiry.passwordexpirypolicy`, `authentik_policies_expression.expressionpolicy`, `authentik_policies_geoip.geoippolicy`, `authentik_policies_password.passwordpolicy`, `authentik_policies_reputation.reputationpolicy`, `authentik_policies.policybinding`, `authentik_providers_ldap.ldapprovider`, `authentik_providers_oauth2.scopemapping`, `authentik_providers_oauth2.oauth2provider`, `authentik_providers_proxy.proxyprovider`, `authentik_providers_radius.radiusprovider`, `authentik_providers_radius.radiusproviderpropertymapping`, `authentik_providers_saml.samlprovider`, `authentik_providers_saml.samlpropertymapping`, `authentik_providers_scim.scimprovider`, `authentik_providers_scim.scimmapping`, `authentik_rbac.role`, `authentik_sources_ldap.ldapsource`, `authentik_sources_ldap.ldapsourcepropertymapping`, `authentik_sources_oauth.oauthsource`, `authentik_sources_oauth.oauthsourcepropertymapping`, `authentik_sources_oauth.useroauthsourceconnection`, `authentik_sources_oauth.groupoauthsourceconnection`, `authentik_sources_plex.plexsource`, `authentik_sources_plex.plexsourcepropertymapping`, `authentik_sources_plex.userplexsourceconnection`, `authentik_sources_plex.groupplexsourceconnection`, `authentik_sources_saml.samlsource`, `authentik_sources_saml.samlsourcepropertymapping`, `authentik_sources_saml.usersamlsourceconnection`, `authentik_sources_saml.groupsamlsourceconnection`, `authentik_sources_scim.scimsource`, `authentik_sources_scim.scimsourcepropertymapping`, `authentik_stages_authenticator_duo.authenticatorduostage`, `authentik_stages_authenticator_duo.duodevice`, `authentik_stages_authenticator_sms.authenticatorsmsstage`, `authentik_stages_authenticator_sms.smsdevice`, `authentik_stages_authenticator_static.authenticatorstaticstage`, `authentik_stages_authenticator_static.staticdevice`, `authentik_stages_authenticator_totp.authenticatortotpstage`, `authentik_stages_authenticator_totp.totpdevice`, `authentik_stages_authenticator_validate.authenticatorvalidatestage`, `authentik_stages_authenticator_webauthn.authenticatorwebauthnstage`, `authentik_stages_authenticator_webauthn.webauthndevice`, `authentik_stages_captcha.captchastage`, `authentik_stages_consent.consentstage`, `authentik_stages_consent.userconsent`, `authentik_stages_deny.denystage`, `authentik_stages_dummy.dummystage`, `authentik_stages_email.emailstage`, `authentik_stages_identification.identificationstage`, `authentik_stages_invitation.invitationstage`, `authentik_stages_invitation.invitation`, `authentik_stages_password.passwordstage`, `authentik_stages_prompt.prompt`, `authentik_stages_prompt.promptstage`, `authentik_stages_user_delete.userdeletestage`, `authentik_stages_user_login.userloginstage`, `authentik_stages_user_logout.userlogoutstage`, `authentik_stages_user_write.userwritestage`, `authentik_brands.brand`, `authentik_blueprints.blueprintinstance`, `authentik_core.group`, `authentik_core.user`, `authentik_core.application`, `authentik_core.token`, `authentik_enterprise.license`, `authentik_providers_google_workspace.googleworkspaceprovider`, `authentik_providers_google_workspace.googleworkspaceprovidermapping`, `authentik_providers_microsoft_entra.microsoftentraprovider`, `authentik_providers_microsoft_entra.microsoftentraprovidermapping`, `authentik_providers_rac.racprovider`, `authentik_providers_rac.endpoint`, `authentik_providers_rac.racpropertymapping`, `authentik_stages_source.sourcestage`, `authentik_events.event`, `authentik_events.notificationtransport`, `authentik_events.notification`, `authentik_events.notificationrule`, `authentik_events.notificationwebhookmapping`]"}
          schema={{"enum":["authentik_tenants.domain","authentik_crypto.certificatekeypair","authentik_flows.flow","authentik_flows.flowstagebinding","authentik_outposts.dockerserviceconnection","authentik_outposts.kubernetesserviceconnection","authentik_outposts.outpost","authentik_policies_dummy.dummypolicy","authentik_policies_event_matcher.eventmatcherpolicy","authentik_policies_expiry.passwordexpirypolicy","authentik_policies_expression.expressionpolicy","authentik_policies_geoip.geoippolicy","authentik_policies_password.passwordpolicy","authentik_policies_reputation.reputationpolicy","authentik_policies.policybinding","authentik_providers_ldap.ldapprovider","authentik_providers_oauth2.scopemapping","authentik_providers_oauth2.oauth2provider","authentik_providers_proxy.proxyprovider","authentik_providers_radius.radiusprovider","authentik_providers_radius.radiusproviderpropertymapping","authentik_providers_saml.samlprovider","authentik_providers_saml.samlpropertymapping","authentik_providers_scim.scimprovider","authentik_providers_scim.scimmapping","authentik_rbac.role","authentik_sources_ldap.ldapsource","authentik_sources_ldap.ldapsourcepropertymapping","authentik_sources_oauth.oauthsource","authentik_sources_oauth.oauthsourcepropertymapping","authentik_sources_oauth.useroauthsourceconnection","authentik_sources_oauth.groupoauthsourceconnection","authentik_sources_plex.plexsource","authentik_sources_plex.plexsourcepropertymapping","authentik_sources_plex.userplexsourceconnection","authentik_sources_plex.groupplexsourceconnection","authentik_sources_saml.samlsource","authentik_sources_saml.samlsourcepropertymapping","authentik_sources_saml.usersamlsourceconnection","authentik_sources_saml.groupsamlsourceconnection","authentik_sources_scim.scimsource","authentik_sources_scim.scimsourcepropertymapping","authentik_stages_authenticator_duo.authenticatorduostage","authentik_stages_authenticator_duo.duodevice","authentik_stages_authenticator_sms.authenticatorsmsstage","authentik_stages_authenticator_sms.smsdevice","authentik_stages_authenticator_static.authenticatorstaticstage","authentik_stages_authenticator_static.staticdevice","authentik_stages_authenticator_totp.authenticatortotpstage","authentik_stages_authenticator_totp.totpdevice","authentik_stages_authenticator_validate.authenticatorvalidatestage","authentik_stages_authenticator_webauthn.authenticatorwebauthnstage","authentik_stages_authenticator_webauthn.webauthndevice","authentik_stages_captcha.captchastage","authentik_stages_consent.consentstage","authentik_stages_consent.userconsent","authentik_stages_deny.denystage","authentik_stages_dummy.dummystage","authentik_stages_email.emailstage","authentik_stages_identification.identificationstage","authentik_stages_invitation.invitationstage","authentik_stages_invitation.invitation","authentik_stages_password.passwordstage","authentik_stages_prompt.prompt","authentik_stages_prompt.promptstage","authentik_stages_user_delete.userdeletestage","authentik_stages_user_login.userloginstage","authentik_stages_user_logout.userlogoutstage","authentik_stages_user_write.userwritestage","authentik_brands.brand","authentik_blueprints.blueprintinstance","authentik_core.group","authentik_core.user","authentik_core.application","authentik_core.token","authentik_enterprise.license","authentik_providers_google_workspace.googleworkspaceprovider","authentik_providers_google_workspace.googleworkspaceprovidermapping","authentik_providers_microsoft_entra.microsoftentraprovider","authentik_providers_microsoft_entra.microsoftentraprovidermapping","authentik_providers_rac.racprovider","authentik_providers_rac.endpoint","authentik_providers_rac.racpropertymapping","authentik_stages_source.sourcestage","authentik_events.event","authentik_events.notificationtransport","authentik_events.notification","authentik_events.notificationrule","authentik_events.notificationwebhookmapping"],"type":"string","title":"ModelEnum"}}
        >
          
        </SchemaItem><SchemaItem
          collapsible={false}
          name={"object_pk"}
          required={false}
          schemaName={"string"}
          qualifierMessage={"**Possible values:** `non-empty`"}
          schema={{"type":"string","minLength":1}}
        >
          
        </SchemaItem>
      </ul>
    </details>
  </TabItem>
</MimeTabs><div>
  <div>
    <ApiTabs
      label={undefined}
      id={undefined}
    >
      <TabItem
        label={"204"}
        value={"204"}
      >
        <div>
          
          
          Successfully unassigned
          
          
        </div><div>
          
        </div>
      </TabItem><TabItem
        label={"400"}
        value={"400"}
      >
        <div>
          
          
          
          
          
        </div><div>
          <MimeTabs
            className={"openapi-tabs__mime"}
            schemaType={"response"}
          >
            <TabItem
              label={"application/json"}
              value={"application/json"}
            >
              <SchemaTabs
                className={"openapi-tabs__schema"}
              >
                <TabItem
                  label={"Schema"}
                  value={"Schema"}
                >
                  <details
                    style={{}}
                    className={"openapi-markdown__details response"}
                    data-collapsed={false}
                    open={true}
                  >
                    <summary
                      style={{}}
                      className={"openapi-markdown__details-summary-response"}
                    >
                      <strong>
                        Schema
                      </strong>
                    </summary><div
                      style={{"textAlign":"left","marginLeft":"1rem"}}
                    >
                      
                    </div><ul
                      style={{"marginLeft":"1rem"}}
                    >
                      <SchemaItem
                        collapsible={false}
                        name={"non_field_errors"}
                        required={false}
                        schemaName={"string[]"}
                        qualifierMessage={undefined}
                        schema={{"type":"array","items":{"type":"string"}}}
                      >
                        
                      </SchemaItem><SchemaItem
                        collapsible={false}
                        name={"code"}
                        required={false}
                        schemaName={"string"}
                        qualifierMessage={undefined}
                        schema={{"type":"string"}}
                      >
                        
                      </SchemaItem><SchemaItem
                        name={"property name*"}
                        required={false}
                        schemaName={"any"}
                        qualifierMessage={undefined}
                        schema={{"type":"object","description":"Validation Error","properties":{"non_field_errors":{"type":"array","items":{"type":"string"}},"code":{"type":"string"}},"additionalProperties":{},"title":"ValidationError"}}
                        collapsible={false}
                        discriminator={false}
                      >
                        
                      </SchemaItem>
                    </ul>
                  </details>
                </TabItem><TabItem
                  label={"Example (from schema)"}
                  value={"Example (from schema)"}
                >
                  <ResponseSamples
                    responseExample={"{\n  \"non_field_errors\": [\n    \"string\"\n  ],\n  \"code\": \"string\"\n}"}
                    language={"json"}
                  >
                    
                  </ResponseSamples>
                </TabItem>
              </SchemaTabs>
            </TabItem>
          </MimeTabs>
        </div>
      </TabItem><TabItem
        label={"403"}
        value={"403"}
      >
        <div>
          
          
          
          
          
        </div><div>
          <MimeTabs
            className={"openapi-tabs__mime"}
            schemaType={"response"}
          >
            <TabItem
              label={"application/json"}
              value={"application/json"}
            >
              <SchemaTabs
                className={"openapi-tabs__schema"}
              >
                <TabItem
                  label={"Schema"}
                  value={"Schema"}
                >
                  <details
                    style={{}}
                    className={"openapi-markdown__details response"}
                    data-collapsed={false}
                    open={true}
                  >
                    <summary
                      style={{}}
                      className={"openapi-markdown__details-summary-response"}
                    >
                      <strong>
                        Schema
                      </strong>
                    </summary><div
                      style={{"textAlign":"left","marginLeft":"1rem"}}
                    >
                      
                    </div><ul
                      style={{"marginLeft":"1rem"}}
                    >
                      <SchemaItem
                        collapsible={false}
                        name={"detail"}
                        required={true}
                        schemaName={"string"}
                        qualifierMessage={undefined}
                        schema={{"type":"string"}}
                      >
                        
                      </SchemaItem><SchemaItem
                        collapsible={false}
                        name={"code"}
                        required={false}
                        schemaName={"string"}
                        qualifierMessage={undefined}
                        schema={{"type":"string"}}
                      >
                        
                      </SchemaItem>
                    </ul>
                  </details>
                </TabItem><TabItem
                  label={"Example (from schema)"}
                  value={"Example (from schema)"}
                >
                  <ResponseSamples
                    responseExample={"{\n  \"detail\": \"string\",\n  \"code\": \"string\"\n}"}
                    language={"json"}
                  >
                    
                  </ResponseSamples>
                </TabItem>
              </SchemaTabs>
            </TabItem>
          </MimeTabs>
        </div>
      </TabItem>
    </ApiTabs>
  </div>
</div>