av project

Manage AlertaVuln projects - the unit that repos, scan findings, and alert settings attach to.

Synopsis

av project <command> [flags]

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

Description

av project groups four subcommands: list, create, get, and delete. Every subcommand requires a login token - run av login first - and operates against the organisation your token is scoped to (see av org switch).

av project list

List all projects.

av project list

list takes no flags. It prints one row per project with the columns ID, NAME, MIN SEVERITY, and CREATED. Use the ID value anywhere a project ID is expected - av project get, av project delete, or av sast scan --project.

List the projects in the active organisation:

av project list

av project create

Create a new project.

av project create --name <name> [flags]

On success the command prints the new project’s name and ID.

Flag	Default	Description
`--name`	-	Project name (required)
`--description`	-	Project description

Create a project with just a name:

av project create --name payments-api

Add a description so teammates know what the project covers:

av project create --name payments-api --description "Payment gateway services"

av project get

Show project details as JSON.

av project get <id>

get takes the project ID as its single argument and prints the full project record - id, name, description, minSeverityThreshold, staleThresholdDays, createdAt, updatedAt - as indented JSON, which makes it the right subcommand for scripting.

Inspect a project:

av project get 3f9d2c81-0b7a-4e5d-9c1f-6a2e8b4d7f10

Extract a single field with jq:

av project get 3f9d2c81-0b7a-4e5d-9c1f-6a2e8b4d7f10 | jq -r .minSeverityThreshold

av project delete

Delete a project.

av project delete <id>

delete takes the project ID as its single argument and prints a confirmation line once the project is gone.

Delete a project by ID:

av project delete 3f9d2c81-0b7a-4e5d-9c1f-6a2e8b4d7f10

Exit codes

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