## GetAuthenticatedUser

`users.get_authenticated_user(UserGetAuthenticatedUserParams**kwargs)  -> UserGetAuthenticatedUserResponse`

**post** `/gitpod.v1.UserService/GetAuthenticatedUser`

Gets information about the currently authenticated user.

Use this method to:

- Get user profile information
- Check authentication status
- Retrieve user settings
- Verify account details

### Examples

- Get current user:

  Retrieves details about the authenticated user.

  ```yaml
  {}
  ```

### Parameters

- `empty: Optional[bool]`

### Returns

- `class UserGetAuthenticatedUserResponse: …`

  - `user: User`

    - `id: str`

      id is a UUID of the user

    - `avatar_url: Optional[str]`

      avatar_url is a link to the user avatar

    - `created_at: Optional[datetime]`

      created_at is the creation time

    - `email: Optional[str]`

      email is the user's email address

    - `name: Optional[str]`

      name is the full name of the user

    - `organization_id: Optional[str]`

      organization_id is the id of the organization this account is owned by.

      +optional if not set, this account is owned by the installation.

    - `status: Optional[UserStatus]`

      status is the status the user is in

      - `"USER_STATUS_UNSPECIFIED"`

      - `"USER_STATUS_ACTIVE"`

      - `"USER_STATUS_SUSPENDED"`

      - `"USER_STATUS_LEFT"`

### Example

```python
import os
from gitpod import Gitpod

client = Gitpod(
    bearer_token=os.environ.get("GITPOD_API_KEY"),  # This is the default and can be omitted
)
response = client.users.get_authenticated_user()
print(response.user)
```

#### Response

```json
{
  "user": {
    "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    "avatarUrl": "avatarUrl",
    "createdAt": "2019-12-27T18:11:19.117Z",
    "email": "email",
    "name": "name",
    "organizationId": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    "status": "USER_STATUS_UNSPECIFIED"
  }
}
```