Files
authentik/website/docs/developer-docs/api/reference/rbac-permissions-assigned-by-roles-unassign-partial-update.api.mdx
2024-09-13 12:17:54 -05:00

337 lines
20 KiB
Plaintext

---
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: 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
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>