# `jadpo routes`

List every route.

List every route the project answers (area 7), grouped by API: its method and full path, the query or action it runs, its authentication and the file it is written in. Authentication is required, none (anyone may call it) or fresh (the caller's record is read now).

```text
jadpo routes
```

## On every command

- `--json`: Print data for tools instead of text
- `--help`: Show every flag, with examples
- `--color <when>`: Choose when to use colour

`jadpo routes --json` writes one JSON document to standard output instead of text, with the same exit code. The document has `schemaVersion`, `command` (`"routes"`), `ok`, `data` (what the command produced, `null` when it failed) and `diagnostics` (each error with its `rule`, `reason`, `next` and `help`). A command that needs a terminal refuses `--json` and names the flags that do the same job.

## Examples

```text
# List the routes of the project you are in
jadpo routes
# Print them as data for tools
jadpo routes --json
```

## Errors

- [`cli.routes_arguments`](../errors/cli.routes_arguments.md): Routes command has invalid arguments
- [`toolchain.project_not_found`](../errors/toolchain.project_not_found.md): Project could not be found