For AI agents: read the documentation index. Documentation pages are available as Markdown by appending .md to their URL, or requesting Accept: text/markdown.

Namera Docs

namera auth status

Inspect the credential and permissions used by ordinary CLI commands.

Inspect the credential and permissions used by ordinary CLI commands.

Usage

namera auth status

Output

With NAMERA_API_KEY supplied through the environment:

OK Connected with an API key
Profile: automation
Organization: Example workspace

Session keys

Example account
-> 🔑 Example session | Active | Expires in 31 days

Example output uses fixture accounts and hashes, captured with the CLI's output formatters. Plain-text output is shown without terminal colors; your values and relative expiry dates will differ.

namera --output json auth status
{
  "profile": "automation",
  "actor": {
    "type": "api-key",
    "data": {
      "actorId": "0199dfe1-0000-7000-8000-000000000014",
      "organizationId": "0199dfe1-0000-7000-8000-000000000004",
      "organizationName": "Example workspace",
      "grants": [
        {
          "grant": {
            "id": "0199dfe1-0000-7000-8000-000000000013",
            "organizationId": "0199dfe1-0000-7000-8000-000000000004",
            "actorId": "0199dfe1-0000-7000-8000-000000000014",
            "sessionKeyId": "0199dfe1-0000-7000-8000-000000000002",
            "grantedByActorId": "0199dfe1-0000-7000-8000-000000000015",
            "revokedAt": null,
            "revokedByActorId": null,
            "createdAt": "2026-10-11T09:00:00.000Z"
          },
          "sessionKey": {
            "id": "0199dfe1-0000-7000-8000-000000000002",
            "organizationId": "0199dfe1-0000-7000-8000-000000000004",
            "walletId": "0199dfe1-0000-7000-8000-000000000001",
            "signingKeyId": "0199dfe1-0000-7000-8000-000000000005",
            "createdByActorId": "0199dfe1-0000-7000-8000-000000000015",
            "metadata": {
              "version": 1,
              "name": "Example session",
              "logo": { "type": "emoji", "value": "🔑" },
              "description": "SDK test session"
            },
            "policyHash": "0x3333333333333333333333333333333333333333333333333333333333333333",
            "status": "active",
            "revokedAt": null,
            "revokedByActorId": null,
            "createdAt": "2026-10-11T09:00:00.000Z",
            "namespace": "eip155",
            "policies": [
              {
                "id": "0199dfe1-0000-7000-8000-000000000016",
                "appliesTo": "both",
                "type": "evm.chain-allowlist",
                "version": 1,
                "chainIds": ["eip155:84532"]
              }
            ]
          }
        }
      ],
      "apiKey": {
        "id": "0199dfe1-0000-7000-8000-000000000017",
        "metadata": {
          "version": 1,
          "name": "Example integration",
          "logo": { "type": "emoji", "value": "🔑" },
          "description": "SDK test credential"
        },
        "keyStart": "example-prefix",
        "expiresAt": null,
        "lastUsedAt": "2026-10-11T09:10:00.000Z",
        "createdAt": "2026-10-11T09:00:00.000Z"
      }
    }
  }
}

Options

--profile

  • Type: string
  • Default: personal

Choose the saved CLI connection for this command. Pass the same name used at login. If NAMERA_API_KEY is set, ordinary API commands use that key instead of the profile's OAuth credentials.

namera wallet list --profile work

The command also accepts global options: --output pretty|json, --quiet, and --help.

Human output may also read accounts and session keys to show their names and installation expiry when your scopes permit those reads. JSON returns profile and the full actor without those additional requests. This is an authenticated API check, not just a check for a saved token.

Errors

Failures exit nonzero and are written to stderr. With --output json, inspect error.code and error.nextStep. See Output and Errors.