Docs menu

Operate

Your account and security notices

Add an email for security notices, protect your sign-in with a passkey or an authenticator app, and what CLI tells you about.

Explain it

CLI tells you when something important happens on your account, so you'd notice if it wasn't you:

  • someone signed in from a device or browser it hasn't seen before;
  • a new API key was made for one of your projects;
  • a GitHub account was linked;
  • money is being withdrawn to an address the project hasn't paid before. That withdrawal waits 48 hours, so you can cancel it if it's not yours.

Where the notices go. If you sign in with email, they go there. If you sign in with a wallet or GitHub, add an email under Account settings and confirm it with the 6-digit code CLI sends. Apps like ChatGPT that ask for your email also get this confirmed address.

Protect your sign-in. Under Account settings, add a passkey (your fingerprint or face, or a security key) or an authenticator app. Risky actions, like revealing a secret or withdrawing money, then ask you to confirm it's you. You can see every device that's signed in, and sign any of them out, on the same page.

A confirmed email

API
GET /v1/me/email
POST /v1/me/email {"email": "[email protected]"}
POST /v1/me/email/verify {"code": "123456"}
DELETE /v1/me/email

GET returns {email, verified, source, pending}; source is sign-in for email accounts and added for one added and confirmed. Codes last 15 minutes; 5 wrong tries end a code, and at most 5 codes are sent an hour. People only, not API keys or connected apps. GET /v1/me carries contactEmail.

Connected apps that ask for the email scope get it from /oauth/userinfo with email_verified: true. If the person has none, the consent screen asks for one first (needsEmail on GET /v1/oauth/requests/:id, and approving without one is refused).

Notices

NoticeWhen
New sign-ina sign-in from a device and browser not seen on this account before (kept per account as known devices)
New API keyany key made for a project you own or administer
GitHub linkeda GitHub account linked to your sign-in
Withdrawal to a new addressa withdrawal to an address the project hasn't been paid at; held for CLI_PAYOUT_NEW_ADDRESS_HOLD_HOURS (48)

Cancel a held withdrawal with POST /v1/projects/:id/withdrawals/:payoutId/cancel (admins). Withdrawals over a project's 24-hour limit (CLI_PAYOUT_PROJECT_DAILY_USD, 2,500) go to an operator for review.

Second factors and step-up

Passkeys (WebAuthn) and authenticator apps (TOTP, with recovery codes) are under /v1/me/2fa. With either set up, step-up routes need a recent confirmation: revealing variables and connection strings, running commands or write queries, migrations, creating keys, withdrawals, self-funding payouts, revenue splits and deleting projects. A project can require every member to have a second factor (see /docs/access-reviews). Sessions: see and end them under Account settings; details in Teams and security.