You're viewing documentation for the legacy version of Firezone, now End-of-Life. View the latest docs here.

REST API

Welcome to Firezone's REST API v0 documentation.

Getting started

To get started with the REST API, you'll first need an API token. This can be generated in the UI at /settings/account or via the CLI with:

docker compose -f $HOME/.firezone/docker-compose.yml exec firezone bin/create-api-token

Note: The token is written to STDOUT by default. You may wish to redirect its output to a file instead:

docker compose -f $HOME/.firezone/docker-compose.yml exec firezone bin/create-api-token > fz_token

API tokens generated from the CLI are owned by the primary administrator specified by the DEFAULT_ADMIN_EMAIL environment variable.