> ## Documentation Index
> Fetch the complete documentation index at: https://delivery.vexa.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# vexa_subscriber.py

> Manage credentials on the channel registry.

Source: `publisher/vexa_subscriber.py` · audience: publisher

## Overview

Emitted from `python3 publisher/vexa_subscriber.py --help`.

```text theme={null}
usage: vexa_subscriber [-h] {list,add,revoke} ...

Manage credentials on the Vexa channel registry (channel.vexa.ai).

positional arguments:
  {list,add,revoke}
    list             show accounts and their scope
    add              mint a credential for an account (also rotates an existing one)
    revoke           remove an account's credential

options:
  -h, --help         show this help message and exit
```

## `list`

Show every account on the channel registry and its scope. The first thing to run when a customer reports a 401, and the inventory you reconcile against before a rotation.

```text theme={null}
usage: vexa_subscriber list [-h]

options:
  -h, --help  show this help message and exit
```

## `add`

Mint a credential for an account — the same verb rotates an existing one. Onboarding a new subscriber and rotating a compromised one are the same act against the registry, and both end with an age-encrypted handoff.

```text theme={null}
usage: vexa_subscriber add [-h] name

positional arguments:
  name        account name, e.g. 'pilot'

options:
  -h, --help  show this help message and exit
```

## `revoke`

Remove an account's credential. Use it when a pilot ends or a credential is suspected: revocation stops future pulls, it does not un-deliver what the subscriber already has.

```text theme={null}
usage: vexa_subscriber revoke [-h] [--force] name

positional arguments:
  name

options:
  -h, --help  show this help message and exit
  --force     allow revoking the publisher account
```