ADadaptyvbio
whoami

Who am I

Identify yourself from your API token. Returns the organizations your token can access — with the organization you are currently acting as marked active: true — along with your user id, the permissions your token grants, and when the token expires.

This is a safe, read-only call: it does not create or change anything. Use it to look up your organization's name and id (needed by other endpoints) or to check what your token is allowed to do.

get/api/v1/whoami

Request

  • Base URL
    https://devs.adaptyvbio.com
  • URL
    https://devs.adaptyvbio.com/api/v1/whoami
  • Auth
    HTTP bearer

Response

Caller identity and access summary

active_organization_idstring uuid nullable

Identifier of the organization the token is currently acting as. This is the organization flagged active: true in organizations.

permissionsstring[] required

The permissions this token grants, as resource:action strings (for example experiment:create). Use these to learn what the token can do before attempting an operation.

token_expires_atstring date-time nullable

When the token expires (ISO 8601 / RFC 3339, UTC). null for tokens without a recorded expiry.

user_idstring uuid nullable

The authenticated user's unique identifier.

Example response

{
  "active_organization_id": "019b8da3-4a91-16c6-fa94-619212bee6a6",
  "organizations": [
    {
      "active": true,
      "id": "019b8da3-4a91-16c6-fa94-619212bee6a6",
      "name": "Acme Biotech",
      "role": "member"
    }
  ],
  "permissions": [
    "organization:read",
    "experiment:read",
    "experiment:create"
  ],
  "token_expires_at": "2026-12-31T23:59:59Z",
  "user_id": "019b8da3-1111-2222-3333-444455556666"
}

Changes

No recorded changes to this operation across all 1 revision of this API.