Edit user


Request description

Endpoint: /users/:id/update
Method: PATCH

The following parameter must be passed through the URL:

  • id: specifies the unique user identifier
{
  "Content-Type": "application/json",
  "Authorization": "Bearer <accessToken>"
}

Note: the <accessToken> is obtained as a result of the authentication

Payload

{
  "fullName": "mock-full-name",
  "groupId": "group-id",
  "userType": "REGULAR"
}

Payload structure

type EditUserPayloadType = {
  fullName?: string,
  groupId?: string,
  userType?: UserType
}

type UserType = 'ORGANIZATION_OWNER' | 'ORGANIZATION_ADMIN' | 'REGULAR'

Responses

Correct response

Successful request

Describe the characteristics of a satisfactory response

200

Response structure:

{
  // empty response
}

Wrong responses

Unauthorized request

Describe the characteristics of an unauthorized request

401

Response body

{
  // empty body
}

Description: this error occurs when endpoint authorizers fail to validate the token sent in the request header.

Not found

Describe the characteristics of a not found request

404

Response body

{
  // empty body
}

Description: this error occurs when an user not found.

Bad request

Describe the characteristics of a bad request

400

Response body

type EditUserResponseType = {
    errorType: Edit_USER_ERROR_TYPE,
    errorMessage?: string
}

enum Edit_USER_ERROR_TYPE {
  USER_NOT_FOUND= 'userNotFound'
  UNAUTHORIZED_RESOURCE = 'unauthorizedResource',
  INVALID_GROUP_ID = 'invalidGroupId',
  INVALID_ORGANIZATION_ROLE= 'invalidOrganizationRole'  
}