Minctrl Docs

Change a member's role

PATCH
/companies/{company_id}/members/{user_id}

Change an existing member's role.

Requires a valid bearer token and the member.role.change capability on the company. Company-scoped to the company_id in the path. Owner-protection invariants (e.g. demoting the sole owner) raise 400.

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Path Parameters

company_id*Company Id
user_id*User Id

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Request body to change a member's role.

Response Body

application/json

application/json

curl -X PATCH "https://example.com/companies/string/members/string" \  -H "Content-Type: application/json" \  -d '{    "role": "manager"  }'
null
Empty
Empty
Empty
{  "detail": [    {      "loc": [        "string"      ],      "msg": "string",      "type": "string",      "input": null,      "ctx": {}    }  ]}