---
id: onboard-operator-update-organisation-admin-role
title: "Change organisation admin role"
description: "Changes the role of an admin of the organisation, for example to give an organisation a new super admin when its only super admin left. The roles of the admin in other organisations do not change. In the dashboard, this is **Change Admin Role**."
sidebar_label: "Change organisation admin role"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "put api-method"
info_path: docs/openid4vc-api/igrant-io-api-documentation
custom_edit_url: null
---

> **Build this with an AI coding agent.** Install the iGrant.io Agent Skills, then ask your agent to build the integration:
>
> ```bash
> npx skills add L3-iGrant/skills
> ```


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 OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";

<h1 className={"openapi__heading"}>Change organisation admin role</h1>

<MethodEndpoint method={"put"} path={"/v4/onboard/platform/operator/organisation/{organisationId}/admin/{adminId}/role"}></MethodEndpoint>



Changes the role of an admin of the organisation, for example to give an organisation a new super admin when its only super admin left. The roles of the admin in other organisations do not change. In the dashboard, this is **Change Admin Role**.

- **Same role:** a request for the role that the admin has changes nothing and gets the same answer. An admin with an older role (`Admin`, `Dpo` or `Developer`) has the access of `NormalAdmin`: the role `NormalAdmin` keeps the older role.
- **Last active super admin:** an organisation keeps one active super admin, that is a super admin who logged in at least once and is not disabled. An invited super admin who never logged in, and a disabled super admin, do not count. The role of the last active super admin cannot change to `NormalAdmin` (`409` `last_super_admin`).
- **Effect:** the change has effect within 60 seconds. After that, the access token of the admin with the old role gets `401`, and the dashboard of the admin gets a token with the new role at its next refresh. The sessions of the admin do not end.
- **Access of the account:** a disabled admin stays disabled. The operations of a super admin (below `/super-admin/{adminId}`) act on super admins only: after the change to `NormalAdmin`, they answer `404` for the admin.

The account actions of the admin get `role_changed_to_super_admin` or `role_changed_to_admin`. A suspended organisation is accepted.


## Request

<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={{"name":"organisationId","in":"path","required":true,"description":"The ID of the organisation, from [List organisations of the installation](/docs/openid4vc-api/onboard-operator-list-organisations).","schema":{"type":"string","maxLength":256,"example":"6731f0c2a1b2c3d4e5f60789"}}}></ParamsItem><ParamsItem className={"paramsItem"} param={{"name":"adminId","in":"path","required":true,"description":"The ID of an admin of the organisation, from [List organisation admins](/docs/openid4vc-api/onboard-operator-list-organisation-admins).","schema":{"type":"string","maxLength":256,"example":"6731f1d8a1b2c3d4e5f6078b"}}}></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><strong className={"openapi-schema__required"}>required</strong></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}></div><ul style={{"marginLeft":"1rem"}}><SchemaItem collapsible={false} name={"role"} required={true} schemaName={"string"} qualifierMessage={"**Possible values:** [`SuperAdmin`, `NormalAdmin`]"} schema={{"type":"string","enum":["SuperAdmin","NormalAdmin"],"description":"`SuperAdmin` (Super Admin in the dashboard): manages the organisation and its team. `NormalAdmin` (Administrator in the dashboard): manages the organisation, but not the team.","example":"SuperAdmin"}}></SchemaItem></ul></details></TabItem></MimeTabs><div><div><ApiTabs label={undefined} id={undefined}><TabItem label={"200"} value={"200"}><div>

The admin after the change.

</div><details style={{"textAlign":"left","marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collaposed={true} open={false}><summary style={{}}><strong>Response Headers</strong></summary><ul style={{"marginLeft":"1rem"}}></ul></details><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={true} className={"schemaItem"}><details style={{}} className={"openapi-markdown__details"}><summary style={{}}><span className={"openapi-schema__container"}><strong className={"openapi-schema__property"}>admin</strong><span className={"openapi-schema__name"}> object</span><span className={"openapi-schema__divider"}></span><span className={"openapi-schema__required"}>required</span></span></summary><div style={{"marginLeft":"1rem"}}><div style={{"marginTop":".5rem","marginBottom":".5rem"}}>

An admin account as a platform admin sees it.

</div><SchemaItem collapsible={false} name={"id"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"The ID of the admin.","example":"6731f1d8a1b2c3d4e5f6078a"}}></SchemaItem><SchemaItem collapsible={false} name={"email"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"The e-mail address of the admin.","example":"jane.doe@acme-bank.example.com"}}></SchemaItem><SchemaItem collapsible={false} name={"name"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"The name of the admin.","example":"Jane Doe"}}></SchemaItem><SchemaItem collapsible={false} name={"roleName"} required={true} schemaName={"string"} qualifierMessage={"**Possible values:** [`Admin`, `Dpo`, `Developer`, `SuperAdmin`, `NormalAdmin`]"} schema={{"type":"string","enum":["Admin","Dpo","Developer","SuperAdmin","NormalAdmin"],"description":"The role of the admin in its organisation: `SuperAdmin` (Super Admin in the dashboard) or `NormalAdmin` (Administrator). `Admin`, `Dpo` and `Developer` are roles of older records, with the access of `NormalAdmin`.","example":"SuperAdmin"}}></SchemaItem><SchemaItem collapsible={true} className={"schemaItem"}><details style={{}} className={"openapi-markdown__details"}><summary style={{}}><span className={"openapi-schema__container"}><strong className={"openapi-schema__property"}>organisation</strong><span className={"openapi-schema__name"}> object</span><span className={"openapi-schema__divider"}></span><span className={"openapi-schema__required"}>required</span></span></summary><div style={{"marginLeft":"1rem"}}><div style={{"marginTop":".5rem","marginBottom":".5rem"}}>

The organisation of the admin.

</div><SchemaItem collapsible={false} name={"id"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"The ID of the organisation.","example":"6731f0c2a1b2c3d4e5f60789"}}></SchemaItem><SchemaItem collapsible={false} name={"name"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"The name of the organisation.","example":"Acme Bank"}}></SchemaItem></div></details></SchemaItem><SchemaItem collapsible={false} name={"status"} required={true} schemaName={"string"} qualifierMessage={"**Possible values:** [`invited`, `active`, `passwordChangeRequired`, `disabled`]"} schema={{"type":"string","enum":["invited","active","passwordChangeRequired","disabled"],"description":"The state of the account. `invited`: the admin has not set a password yet. `passwordChangeRequired`: the admin must set a new password at the next login, for example after a one-time password. `disabled`: a platform admin disabled the account.","example":"active"}}></SchemaItem><SchemaItem collapsible={false} name={"lastSignIn"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","nullable":true,"description":"The time of the last login of the admin, or `null` before the first login.","example":"2026-11-12T09:30:00Z"}}></SchemaItem><SchemaItem collapsible={true} className={"schemaItem"}><details style={{}} className={"openapi-markdown__details"}><summary style={{}}><span className={"openapi-schema__container"}><strong className={"openapi-schema__property"}>platformAdmin</strong><span className={"openapi-schema__name"}> object</span><span className={"openapi-schema__divider"}></span><span className={"openapi-schema__nullable"}>nullable</span><span className={"openapi-schema__required"}>required</span></span></summary><div style={{"marginLeft":"1rem"}}><div style={{"marginTop":".5rem","marginBottom":".5rem"}}>

Who gave the platform admin right and when, or `null` for an admin without the right.

</div><SchemaItem collapsible={false} name={"grantedBy"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"The name of the platform admin who gave the right (the e-mail address of an admin without a name), `operatorCommand` when a command of the installation gave it, or the ID of the admin when that admin cannot be read.","example":"operatorCommand"}}></SchemaItem><SchemaItem collapsible={false} name={"grantedAt"} required={true} schemaName={"date-time"} qualifierMessage={undefined} schema={{"type":"string","format":"date-time","description":"When the right was given (RFC 3339, UTC).","example":"2026-11-12T08:00:00Z"}}></SchemaItem></div></details></SchemaItem></div></details></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"admin\": {\n    \"id\": \"6731f1d8a1b2c3d4e5f6078a\",\n    \"email\": \"jane.doe@acme-bank.example.com\",\n    \"name\": \"Jane Doe\",\n    \"roleName\": \"SuperAdmin\",\n    \"organisation\": {\n      \"id\": \"6731f0c2a1b2c3d4e5f60789\",\n      \"name\": \"Acme Bank\"\n    },\n    \"status\": \"active\",\n    \"lastSignIn\": \"2026-11-12T09:30:00Z\",\n    \"platformAdmin\": {\n      \"grantedBy\": \"operatorCommand\",\n      \"grantedAt\": \"2026-11-12T08:00:00Z\"\n    }\n  }\n}"} language={"json"}></ResponseSamples></TabItem><TabItem label={"Example"} value={"Example"}><ResponseSamples responseExample={"{\n  \"admin\": {\n    \"id\": \"6731f1d8a1b2c3d4e5f6078b\",\n    \"email\": \"erik.berg@acme-bank.example.com\",\n    \"name\": \"Erik Berg\",\n    \"roleName\": \"SuperAdmin\",\n    \"organisation\": {\n      \"id\": \"6731f0c2a1b2c3d4e5f60789\",\n      \"name\": \"Acme Bank\"\n    },\n    \"status\": \"active\",\n    \"lastSignIn\": \"2026-11-18T08:15:00Z\",\n    \"platformAdmin\": null\n  }\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem><TabItem label={"400"} value={"400"}><div>

The body is not valid (`errorKey` `invalid_request`): it is not JSON, it has no `role` or another member, or `role` is not `SuperAdmin` or `NormalAdmin`.

</div><details style={{"textAlign":"left","marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collaposed={true} open={false}><summary style={{}}><strong>Response Headers</strong></summary><ul style={{"marginLeft":"1rem"}}></ul></details><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={"errorCode"} required={true} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","example":400}}></SchemaItem><SchemaItem collapsible={false} name={"errorDescription"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","example":"Bad input parameter"}}></SchemaItem><SchemaItem collapsible={false} name={"errorKey"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"A text code of the refusal that does not change when the text changes. Only some refusals have it, for example `organisation_suspended`, `feature_disabled`, `service_not_installed` or `purpose_exists`. Some refusals have more members: `feature_disabled` has `feature`, and `service_not_installed` has `service` (the service that is not installed: `wallet` or `consent`)."}}></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"errorCode\": 400,\n  \"errorDescription\": \"Bad input parameter\",\n  \"errorKey\": \"string\"\n}"} language={"json"}></ResponseSamples></TabItem><TabItem label={"Example"} value={"Example"}><ResponseSamples responseExample={"{\n  \"errorCode\": 400,\n  \"errorKey\": \"invalid_request\",\n  \"errorDescription\": \"field role must be \\\"SuperAdmin\\\" or \\\"NormalAdmin\\\"\"\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem><TabItem label={"401"} value={"401"}><div>

The `Authorization` header is missing, or the access token is not valid or has expired.

</div><details style={{"textAlign":"left","marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collaposed={true} open={false}><summary style={{}}><strong>Response Headers</strong></summary><ul style={{"marginLeft":"1rem"}}></ul></details><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={"errorCode"} required={true} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","example":400}}></SchemaItem><SchemaItem collapsible={false} name={"errorDescription"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","example":"Bad input parameter"}}></SchemaItem><SchemaItem collapsible={false} name={"errorKey"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"A text code of the refusal that does not change when the text changes. Only some refusals have it, for example `organisation_suspended`, `feature_disabled`, `service_not_installed` or `purpose_exists`. Some refusals have more members: `feature_disabled` has `feature`, and `service_not_installed` has `service` (the service that is not installed: `wallet` or `consent`)."}}></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"errorCode\": 400,\n  \"errorDescription\": \"Bad input parameter\",\n  \"errorKey\": \"string\"\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem><TabItem label={"403"} value={"403"}><div>

The caller cannot call the operations of a platform admin. A login of an admin who is not a platform admin (an admin of another organisation, or an admin of the platform operator organisation without the platform admin right) gets `errorKey` `not_platform_admin`. An API key gets the older body `{"Code", "Message"}`: no API key can call these operations.

</div><details style={{"textAlign":"left","marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collaposed={true} open={false}><summary style={{}}><strong>Response Headers</strong></summary><ul style={{"marginLeft":"1rem"}}></ul></details><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"}}><div><span className={"badge badge--info"}>anyOf</span><SchemaTabs><TabItem label={"MOD1"} value={"0-item-properties"}><SchemaItem collapsible={false} name={"errorCode"} required={true} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","example":400}}></SchemaItem><SchemaItem collapsible={false} name={"errorDescription"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","example":"Bad input parameter"}}></SchemaItem><SchemaItem collapsible={false} name={"errorKey"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"A text code of the refusal that does not change when the text changes. Only some refusals have it, for example `organisation_suspended`, `feature_disabled`, `service_not_installed` or `purpose_exists`. Some refusals have more members: `feature_disabled` has `feature`, and `service_not_installed` has `service` (the service that is not installed: `wallet` or `consent`)."}}></SchemaItem></TabItem><TabItem label={"Older error body"} value={"1-item-properties"}><SchemaItem collapsible={false} name={"Code"} required={true} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","description":"The HTTP status.","example":403}}></SchemaItem><SchemaItem collapsible={false} name={"Message"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"What went wrong.","example":"Unauthorised access;User doesn't have enough permissions;"}}></SchemaItem></TabItem></SchemaTabs></div></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{}"} language={"json"}></ResponseSamples></TabItem><TabItem label={"Example"} value={"Example"}><ResponseSamples responseExample={"{\n  \"errorCode\": 403,\n  \"errorKey\": \"not_platform_admin\",\n  \"errorDescription\": \"Access denied: only a platform admin of the platform operator organisation can call this route\"\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem><TabItem label={"404"} value={"404"}><div>

No organisation has the ID (`errorKey` `organisation_not_found`), or the account is not an admin of the organisation (`account_not_found`).

</div><details style={{"textAlign":"left","marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collaposed={true} open={false}><summary style={{}}><strong>Response Headers</strong></summary><ul style={{"marginLeft":"1rem"}}></ul></details><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={"errorCode"} required={true} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","example":400}}></SchemaItem><SchemaItem collapsible={false} name={"errorDescription"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","example":"Bad input parameter"}}></SchemaItem><SchemaItem collapsible={false} name={"errorKey"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"A text code of the refusal that does not change when the text changes. Only some refusals have it, for example `organisation_suspended`, `feature_disabled`, `service_not_installed` or `purpose_exists`. Some refusals have more members: `feature_disabled` has `feature`, and `service_not_installed` has `service` (the service that is not installed: `wallet` or `consent`)."}}></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"errorCode\": 400,\n  \"errorDescription\": \"Bad input parameter\",\n  \"errorKey\": \"string\"\n}"} language={"json"}></ResponseSamples></TabItem><TabItem label={"Example"} value={"Example"}><ResponseSamples responseExample={"{\n  \"errorCode\": 404,\n  \"errorKey\": \"account_not_found\",\n  \"errorDescription\": \"The account does not exist\"\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem><TabItem label={"409"} value={"409"}><div>

The role cannot change. `errorKey`: `organisation_deleting` (the deletion of the organisation started) or `last_super_admin` (the admin is the last active super admin of the organisation).

</div><details style={{"textAlign":"left","marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collaposed={true} open={false}><summary style={{}}><strong>Response Headers</strong></summary><ul style={{"marginLeft":"1rem"}}></ul></details><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={"errorCode"} required={true} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","example":400}}></SchemaItem><SchemaItem collapsible={false} name={"errorDescription"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","example":"Bad input parameter"}}></SchemaItem><SchemaItem collapsible={false} name={"errorKey"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"A text code of the refusal that does not change when the text changes. Only some refusals have it, for example `organisation_suspended`, `feature_disabled`, `service_not_installed` or `purpose_exists`. Some refusals have more members: `feature_disabled` has `feature`, and `service_not_installed` has `service` (the service that is not installed: `wallet` or `consent`)."}}></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"errorCode\": 400,\n  \"errorDescription\": \"Bad input parameter\",\n  \"errorKey\": \"string\"\n}"} language={"json"}></ResponseSamples></TabItem><TabItem label={"Example"} value={"Example"}><ResponseSamples responseExample={"{\n  \"errorCode\": 409,\n  \"errorKey\": \"last_super_admin\",\n  \"errorDescription\": \"The account is the last active super admin of its organisation (an active super admin logged in at least once and is not disabled)\"\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem><TabItem label={"500"} value={"500"}><div>

The role cannot be changed because of an internal error.

</div><details style={{"textAlign":"left","marginBottom":"1rem"}} className={"openapi-markdown__details"} data-collaposed={true} open={false}><summary style={{}}><strong>Response Headers</strong></summary><ul style={{"marginLeft":"1rem"}}></ul></details><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={"errorCode"} required={true} schemaName={"integer"} qualifierMessage={undefined} schema={{"type":"integer","example":400}}></SchemaItem><SchemaItem collapsible={false} name={"errorDescription"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","example":"Bad input parameter"}}></SchemaItem><SchemaItem collapsible={false} name={"errorKey"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"A text code of the refusal that does not change when the text changes. Only some refusals have it, for example `organisation_suspended`, `feature_disabled`, `service_not_installed` or `purpose_exists`. Some refusals have more members: `feature_disabled` has `feature`, and `service_not_installed` has `service` (the service that is not installed: `wallet` or `consent`)."}}></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"errorCode\": 400,\n  \"errorDescription\": \"Bad input parameter\",\n  \"errorKey\": \"string\"\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem></ApiTabs></div></div>
      