Out Plane
env

env list

List an application's environment variables.

read onlyrepeatable

Every variable set on the application, with the values hidden unless you ask for them.

What the application receives through a shared group is not included here. That is env group get.

Usage

outplane env list [flags]

Flags

FlagTypeDescription
--appstringApplication name or id. Defaults to the linked app. A flag rather than an argument, so that variable names cannot be mistaken for it.
--revealboolPrint the values instead of hiding them.

The global flags apply as well.

Output

FieldTypeDescription
keystring
valuestringThe value, or a mask when --reveal was not given. Read revealed to know which one you have.
revealedboolWhether value is the real value.
lengthintThe value's length, which is reported even when it is hidden.

Examples

Which variables are set on the linked app

outplane env list

The same for a named app, with values

outplane env list --app checkout --reveal

Just the names

outplane env list --json --fields key
{
  "items": [
    {
      "key": "DATABASE_URL"
    },
    {
      "key": "PORT"
    }
  ],
  "total": 2,
  "truncated": false
}

What to Know

  • value is masked unless --reveal is given, in every format including --json. Check revealed before treating it as a credential; length is accurate either way.
  • Variables an application receives from a shared group are not listed. This reports what is set on the application itself.
  • Keys are compared case-insensitively by the platform, so PATH and path are the same variable.

Errors

Beyond 0 for success, this command exits with:

ExitKindMeaning
2usageInvalid arguments, unknown flag, or client-side validation failure.
3authNot authenticated, token revoked or expired, or forbidden for this team.
5not_foundThe named resource does not exist, or is not visible to this credential.
8upstreamThe Out Plane API returned a server error.

The code on the error object is one of context.no_app, app.not_found. Branch on that, or on the exit status. The message is prose and changes.

On this page