---
title: "Who am I"
method: GET
path: "/users/v2/whoami"
tags: ["Context"]
---

# Who am I

`GET /users/v2/whoami`

## Request

- Base URL: `https://odyssey.asteroid.ai`
- URL: `https://odyssey.asteroid.ai/users/v2/whoami`
- Auth: API key in header `X-Api-Key`

Returns who the request acts as and for which organization. Use it to check a credential before you rely on it.

## Response `200`

The request has succeeded.

- UsersWhoamiWhoamiResponse: Who is calling, and for which organization
  - `apiKeyId` string: The user-scoped key that authenticated the request, when one did. An org key's id is `id`.
  - `credential` 'jwt' | 'user_api_key' | 'org_api_key' | 'service' | 'staff_token', required: The credential that authenticated the request
  - `id` string, required: The person's id, the key's id, or the service's name
  - `kind` 'person' | 'api_key' | 'service', required: The kind of caller a request acts as
  - `onBehalfOf` string, uuid
  - `organizationId` string, uuid
  - `person` UsersWhoamiWhoamiPerson: The person a request acts as. Absent for an org key or a service.
    - `email` string, required
    - `id` string, uuid, required

## Other responses

- `400`: The server could not understand the request due to invalid syntax.
- `401`: Access is unauthorized.
- `403`: Access is forbidden.
- `404`: The server cannot find the requested resource.
- `500`: Server error

---

[API](https://skmtc.dev/asteroid/apis/agent-service.md) - [All operations](https://skmtc.dev/asteroid/apis/agent-service/llms.txt) - [OpenAPI document](https://skmtc.dev/asteroid/apis/agent-service/revisions/ccc134d1d510?raw)