Skip to content

Quickstart

Create your organization and first project, and meet the assistant, in a few minutes.

Get from nothing to a working project in a few minutes. Every step below can be done in the dashboard, by asking the assistant, or against the API. Pick whichever fits how you like to work.

1. Get an account

Use Flagon hosted at app.flagon.io, or run it yourself. If you would rather self-host, jump to Self-hosting Flagon and come back here.

2. Create an organization

Everything in Flagon lives inside an organization: your projects, your members, and your settings. Create one and you land at app.flagon.io/<org>.

3. Create your first project

A project is a deployable app. Create one from your organization's dashboard, or just ask the assistant:

Create a project called billing-api.

Read operations run immediately; anything that changes data (like creating a project) is proposed for you to confirm first, so you stay in control.

4. Drive it from the API

Everything you just did is an API operation. Mint a token with the scopes you need, then call the API:

curl https://api.flagon.io/orgs/<org>/projects \
  -H "Authorization: Bearer $FLAGON_TOKEN"

See Authentication and scopes for how tokens and scopes work, and Using the API for the full reference.

Next steps