/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

x-account-id header string

Account ID for the request

email path string

Email address of the user to update roles for

{
  "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,
  "message": "string"
}

Description

Unauthorized - not authenticated

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

Description

Forbidden - user does not have required permissions

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

Description

Not found - user with specified email does not exist

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

References

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

#/components/parameters/xAccountIdHeader

OpenAPI
TypeScript

in: header
name: x-account-id
schema:
  type: string
description: Account ID for the request
required: true
example: "2311"

|
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
  message:
    type: string
    description: Detailed error message
description: Error response object
required:
  - error

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

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