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'
}