Skip to main content
DocumentationLibraryReference
On this page

Kater CLI Present and share promotion

kater promotion list

Lists your promotion requests, newest first, each with its state.

A denied request shows who denied it and why.

Examples

Terminal window
# List all your promotion requests
kater promotion list
# List your requests that wait for a decision
kater promotion list --status pending
# List your requests that the data team denied
kater promotion list --status denied

Options

OptionDescription
--status <status>Lists only your requests in this state: pending, approved, denied or withdrawn.

It also takes the global options --json, --kater-root, --scope and --help.

What it shows

Each request has its state, the field and its model, its id, its file, the date you asked and your reason. It also says how many other people asked for the same promotion, but never who.

  • An approved request names the shared field that your definition now reads.
  • A denied request names who denied it and why.
  • A withdrawn request says why. Kater withdraws a request itself when its field no longer exists.

Give a request’s id to kater promotion show or kater promotion withdraw.

See also