Skip to main content
The tenderly whoami command displays information about your currently authenticated Tenderly account, helping you verify your login status and account details.

​
Usage

tenderly whoami
This command has no flags or arguments.

​
Prerequisites

You must be logged in to use this command. Run tenderly login if you haven’t authenticated yet.

​
Output

The command displays different information depending on your account type:

​
User Account

tenderly whoami
Example Output: 
ID: 550e8400-e29b-41d4-a716-446655440000
Email: [email protected]
Username: dev-user

​
Organization Account

tenderly whoami
Example Output: 
ID: 6ba7b810-9dad-11d1-80b4-00c04fd430c8
Organization name: MyCompany
Username: mycompany

​
Information Displayed

​
ID
string
Your unique Tenderly account identifier.This ID is used internally to reference your account in API calls and configurations.
​
Email
string
Your account email address.Displayed for: User accounts only (not organization accounts)
​
Organization name
string
The name of your organization.Displayed for: Organization accounts only (not user accounts)
​
Username
string
Your Tenderly username.This may be empty for some legacy accounts. Both user and organization accounts can have usernames.

​
Examples

​
Check Current Login Status

tenderly whoami
Output (User Account): 
ID: abc123-def456-ghi789
Email: [email protected]
Username: alice

​
Verify Organization Login

tenderly whoami
Output (Organization Account): 
ID: org-uuid-12345
Organization name: BlockchainCorp
Username: blockchain-corp

​
Use Cases

​
Verify Authentication

After logging in, confirm your session: 
tenderly login
tenderly whoami

​
Check Active Account

When working with multiple accounts, verify which one is active: 
tenderly whoami

​
Debugging Configuration Issues

If commands fail, verify your authentication status: 
tenderly whoami
If you see an error, you may need to log in again.

​
CI/CD Pipeline Verification

In automated environments, verify the service account: 
#!/bin/bash
echo "Authenticating with Tenderly..."
tenderly login --authentication-method access-key --access-key $TENDERLY_ACCESS_KEY

echo "Verifying authentication..."
tenderly whoami

​
Behavior

1

Check Login Status

The command first verifies you’re logged in. If not authenticated, you’ll be prompted to run tenderly login.
2

Fetch Principal Information

Makes an API call to retrieve your account details from Tenderly.
3

Display Account Details

Outputs your account information formatted based on account type:
  • Always shows: ID
  • User accounts: Email
  • Organization accounts: Organization name
  • If available: Username

​
Error Scenarios

​
Not Logged In

You need to be logged in to use this command. Please run 'tenderly login' first.
Solution: Authenticate with tenderly login

​
Failed to Fetch User Information

Failed fetching user information. This can happen if you are running an older version of the Tenderly CLI.
Possible causes:
  • Outdated CLI version
  • Network connectivity issues
  • Invalid or expired access key
  • API service disruption
Solution:
  1. Update the CLI: tenderly update
  2. Re-authenticate: tenderly login --force
  3. Check network connectivity

​
Invalid Access Key

If your access key has been revoked or expired: 
Failed fetching user information.
Solution: Re-authenticate with a valid access key: 
tenderly login --force --authentication-method access-key --access-key NEW_KEY

​
Account Types

Tenderly supports two principal types:

​
User Principal

  • Type: Individual user account
  • Shows: Email address
  • Use case: Personal development, individual projects

​
Organization Principal

  • Type: Organization/team account
  • Shows: Organization name
  • Use case: Team collaboration, shared projects
When logged in with an organization account, projects may be shared across team members. The organization name is used when referencing shared projects.

​
Programmatic Usage

For scripts that need to extract account information: 
#!/bin/bash

# Capture whoami output
ACCOUNT_INFO=$(tenderly whoami 2>&1)

# Check if logged in
if echo "$ACCOUNT_INFO" | grep -q "not logged in"; then
    echo "Not authenticated. Logging in..."
    tenderly login
else
    echo "Already authenticated:"
    echo "$ACCOUNT_INFO"
fi
  • tenderly login - Authenticate with Tenderly
  • tenderly logout - Log out of your current session
  • tenderly init - Initialize a project (requires authentication)

Build docs developers (and LLMs) love

Get started for freeTalk to us