/users/{email}/roles

PATCH /users/{email}/roles

Update user roles

Update roles for a specific user

Authentication Required

Authorization: Bearer {token} header string

This header is required to access this endpoint

Required Parameters

email path string

Email address of the user to update roles for

Optional Parameters

Click here to view an exhaustive list of all available parameters

x-account-id header string

The account ID for the request

{
  "flatRolesList": [
    "string"
  ]
}

{
  "flatRolesList": [
    "string"
  ]
}

Try it out

Output:

Responses

Description

Roles updated successfully

{
  "message": "Roles updated"
}

Description

Bad request - invalid input

{
  "error": "string",
  "status": 0
}

Description

Unauthorized - not authenticated

{
  "error": "string",
  "status": 0
}

Description

Forbidden - user does not have required permissions

{
  "error": "string",
  "status": 0
}

Description

Not found - user with specified email does not exist

{
  "error": "string",
  "status": 0
}

References

#/components/parameters/xAccountIdHeader #/components/schemas/Error

#/components/parameters/xAccountIdHeader

OpenAPI
TypeScript

in: header
name: x-account-id
schema:
  type: string
description: The account ID for the request
required: false

|
export type xAccountIdHeader = any; // Schema type not fully supported

#/components/schemas/Error

OpenAPI
TypeScript

type: object
properties:
  error:
    type: string
    description: Error message
  status:
    type: integer
    description: HTTP status code
description: Error response object

|
export interface Error {
  /** Error message */
  error?: string;
  /** HTTP status code */
  status?: number;
}

Route Source Code

Check out the source code for this route entrypoint here: /users/[email]/roles/route.ts

Or the swagger.yaml spec this documentation was generated from: /users/swagger.yaml