<a id="hook-command-relation-ids"></a>

# `relation-ids`

## Summary

Lists all relation IDs for the given endpoint.

## Usage

` relation-ids [options] <name>`

### Options

| Flag             | Default   | Usage                                   |
|------------------|-----------|-----------------------------------------|
| `--format`       | smart     | Specify output format (json|smart|yaml) |
| `-o`, `--output` |           | Specify an output file                  |

## Examples

```none
relation-ids database
```

## Details

`relation-ids` outputs a list of the related applications with a relation name.
Accepts a single argument (relation-name) which, in a relation hook, defaults
to the name of the current relation. The output is useful as input to the
`relation-list`, `relation-get`, `relation-set`, and `relation-model-get` commands
to read or write other relation values.

Only relation ids for relations which are not broken are included.