Authentication

Before deploying agents to Agent Cloud, you need to authenticate the VideoSDK CLI with your account. This section covers the authentication commands that link your local development environment to your VideoSDK account.

Login

The login command authenticates your CLI session with your VideoSDK account.

Usage

videosdk auth login

What Happens

1. Browser Opens: The CLI automatically opens your default browser to the authentication page
2. Login & Confirm: You log in to your VideoSDK account and confirm the CLI authentication request
3. Token Storage: Once approved, an authentication token is securely stored locally
4. Ready to Deploy: The stored token will be used for all future CLI commands

Example Output

$ videosdk auth login

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Authentication
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

ℹ Initiating browser authentication...
✓ Opened authentication URL in browser
  https://app.videosdk.live/cli/confirm-auth?requestId=abc123xyz

⠋ Waiting for authentication...

✓ Successfully authenticated!

Notes

• The CLI will wait for you to complete the authentication in the browser
• If the browser doesn't open automatically, copy and paste the displayed URL
• Authentication will timeout if not completed within the specified time
• You can cancel the authentication anytime by pressing Ctrl+C

Logout

The logout command removes the stored authentication token from your local environment.

Usage

videosdk auth logout

What Happens

1. Token Removal: The stored authentication token is removed from your local configuration
2. Session End: Your CLI session is disconnected from the VideoSDK account

Example Output

$ videosdk auth logout

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Logout
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✓ Successfully logged out

Notes

• After logging out, you'll need to run videosdk auth login again before using authenticated commands
• This command does not affect any existing deployments on Agent Cloud

Next Steps

After authenticating, you're ready to deploy your agents to Agent Cloud. See the deployment documentation for more details.