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
Header
{
"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'
}