Conta e login

Três rotas cuidam do token: uma mostra quem você é para a API, duas fazem o login do CLI pelo navegador e uma revoga o token em uso. Os exemplos usam $STEEL_URL e $STEEL_TOKEN (veja Antes da primeira chamada).

Token em uso

GET /api/v1/me responde com o dono do token, o workspace, o seu papel nele, os escopos, os módulos que valem agora e a validade. É a primeira chamada para testar um token novo.

curl "$STEEL_URL/api/v1/me" \
  -H "Authorization: Bearer $STEEL_TOKEN"

{
  "success": true,
  "statusCode": 200,
  "data": {
    "user": { "id": "cm2usr0001", "name": "Ana Souza", "email": "ana@empresa.com.br" },
    "workspace": { "id": "cm2ws0001", "slug": "acme", "name": "Acme" },
    "role": "ADMIN",
    "scopes": ["api:read", "api:write"],
    "modules": ["SERVICE_DESK", "CRM"],
    "token": { "id": "cm2tok0001", "expiresAt": "2027-01-16T12:00:00.000Z" }
  }
}

modules lista só os módulos do token que continuam habilitados no workspace: se um administrador desligou o CRM, ele some daqui e as rotas do CRM respondem 403.

No CLI:

steel whoami          # usuário, workspace, escopos, módulos e validade
steel whoami --json   # o mesmo objeto data, para scripts

No SDK:

const me = await steel.me()
if (!me.ok) throw new Error(me.error.code)
console.log(me.data.workspace.slug, me.data.scopes)

Erros: 401 UNAUTHORIZED (token ausente, vencido, revogado ou de quem saiu do workspace) e 429 RATE_LIMITED.

Login pelo navegador (fluxo de dispositivo)