agents
agents get
Show a single agent credential
Show one agent credential's metadata: name, Postgres username, policy profile, principal type, status, and timestamps. Secrets are never included; use pgbeam agents rotate to mint fresh secrets.
Usage
pgbeam agents get <id>Options
| Option | Description | Required | Default |
|---|---|---|---|
<id> | Agent credential ID | Yes | - |
Global options
All global options (--token, --profile,
--project, --org, --json, --no-color, --debug) are also available on
this command.
Examples
# Show an agent credential
pgbeam agents get agt_xxx
# Show as JSON
pgbeam agents get agt_xxx --jsonOutput
Prints the credential's ID, name, username, policy, principal type, status, and expiry. With --json, returns the raw credential object.