av org

Manage organisations - list the ones you belong to, switch the active organisation, and inspect its members, pending invites, and audit log.

Synopsis

av org <command> [flags]

The binary ships as alertavuln; av is the common alias - they are interchangeable in every example.

Description

Your login token is scoped to a single organisation at a time; every other CLI command (projects, scans, alerts) operates inside that organisation. av org groups six subcommands: list, get, switch, members, invites, and audit. Every subcommand requires a login token - run av login first.

av org list

List organisations you belong to.

av org list

list takes no flags. It prints one row per organisation with the columns ACTIVE, ID, NAME, and ADMIN; the active organisation - the one your current token is scoped to - is marked with * in the ACTIVE column.

See which organisations you belong to and which one is active:

av org list

av org get

Show the currently active organisation.

av org get

get takes no flags and prints the active organisation’s ID, Name, and Admin status. If the active organisation no longer matches what the server knows about - for example after being removed from it - the command fails and suggests running av login again to refresh the token.

Check which organisation your commands currently run against:

av org get

av org switch

Switch the active organisation.

av org switch <org-id>

switch takes the target organisation ID as its single argument. The server issues a new token scoped to that organisation and the CLI saves it in its config, so every subsequent command runs against the new organisation. Get the ID from av org list.

Switch to another organisation:

av org switch 9b1e5a70-4c3d-4f28-8e6b-2d7f0a913c44

av org members

List members of the active organisation.

av org members [flags]

Prints one row per member with the columns ID, EMAIL, NAME, ADMIN, and JOINED.

Flag	Default	Description
`--json`	`false`	Output raw JSON instead of a table

List the members as a table:

av org members

Feed the member list to a script as JSON:

av org members --json | jq -r '.[].email'

av org invites

List pending invites for the active organisation.

av org invites [flags]

Prints one row per invite with the columns ID, EMAIL, INVITED BY, EXPIRES, and ACCEPTED - ACCEPTED shows the acceptance date, or no if the invite is still pending.

Flag	Default	Description
`--json`	`false`	Output raw JSON instead of a table

Check which invites are still outstanding:

av org invites

av org audit

Show the organisation audit log.

av org audit [flags]

Prints a page of audit entries with a page N/M (T total) header and the columns WHEN, USER, ACTION, ENTITY, and DETAILS. When --page or --page-size is omitted the server applies its defaults (page 1, page size 50).

Flag	Default	Description
`--page`	`1` (server default)	Page number, 1-based
`--page-size`	`50` (server default)	Entries per page
`--json`	`false`	Output raw JSON instead of a table

Show the most recent audit entries:

av org audit

Walk further back through the log with a larger page:

av org audit --page 2 --page-size 100

Export a page of the audit log as JSON:

av org audit --json > audit-page-1.json

Exit codes

Code	Meaning
`0`	Command completed successfully
`1`	Any failure - not logged in, stale token, or API error