Home > Documentation

Profile

The profile endpoint is used to get and set the current user's profile information.

This should not be used often, but it can be useful.

Get the information about the logged user

This endpoint gets the information about the logged user. This endpoint is there to make sure that the API works.

Parameters

This endpoint does not have any parameters.

Response attributes

id integer

The ID of the user.

first_name string

The first name of the user.

last_name string

The last name of the user.

nickname string

The nickname of the user.

email string

The email of the user.

born_at integer

The birth date of the user, in Unix timestamp format.

GET /api/me
{
"id": 4 ,
"first_name": "Ross" ,
"last_name": "Geller" ,
"nickname": "Ross" ,
"email": "[email protected]" ,
"born_at": 479692800
}

Update the information about the logged user

This endpoint updates the information about the logged user.

Only the logged user can update these fields.

If the email is changed, the system will send a new verification email to verify the new email address, and unless the user verifies the new email address, he/she will not be able to access the account.

Please note that your password can not be changed through the API at the moment.

Parameters

first_name string required

The first name of the user. Max 255 characters.

last_name string required

The last name of the user. Max 255 characters.

nickname string

The nickname of the user. Max 255 characters.

email string required

The email of the user. This email should be unique in the instance, and we will validate the email format. Max 255 characters.

born_at string

The birth date of the user. Format: YYYY-MM-DD. Example: 1985-03-15

Response attributes

id integer

The ID of the user.

first_name string

The first name of the user.

last_name string

The last name of the user.

nickname string

The nickname of the user.

email string

The email of the user.

born_at integer

The birth date of the user, in Unix timestamp format.

PUT /api/me
{
"id": 4 ,
"first_name": "Ross" ,
"last_name": "Geller" ,
"nickname": "Ross" ,
"email": "[email protected]" ,
"born_at": 479692800
}

Get the timezone of the logged user

This endpoint retrieves the timezone information of the currently logged in user.

Parameters

This endpoint does not have any parameters.

Response attributes

timezone string

The timezone of the user in IANA format.

GET /api/me/timezone
{
"timezone": "America/New_York"
}

Update the timezone of the logged user

This endpoint updates the timezone of the currently logged in user.

The timezone must be a valid IANA timezone identifier (e.g., "America/New_York", "Europe/London").

Parameters

timezone string required

The timezone of the user in IANA format (e.g., 'America/New_York', 'Europe/London').

Response attributes

timezone string

The updated timezone of the user in IANA format.

PUT /api/me/timezone
{
"timezone": "Europe/London"
}
Taylor Swift being happy

Please login to vote.

It's free and will help us improve the page.

Taylor will be proud of you.

Last updated on April 5, 2025.