# Overview (/)



This site hosts the API reference generated from the Fly.io Machines API OpenAPI
specification. For how to get started, deeper explanations of each endpoint, and
examples, visit the complete [Machines API docs](https://fly.io/docs/machines/api/).

<SpecDownload />

## Base URL [#base-url]

All requests are made against:

```
https://api.machines.dev/v1
```

## Authentication [#authentication]

Authenticate every request with a Fly.io access token using the
`Authorization: FlyV1 <token>` header. Generate one with
[`fly tokens create`](https://fly.io/docs/flyctl/tokens-create/) or the
[Tokens](https://fly.io/tokens) page on the dashboard.

```bash
curl https://api.machines.dev/v1/apps?org_slug=personal \
  -H "Authorization: Bearer $FLY_API_TOKEN"
```

## Resources [#resources]

<Cards>
  <Card title="Apps" href="/apps/Apps_list" description="Group your Machines into apps." />

  <Card title="Machines" href="/machines/Machines_list" description="Launch and control fast-booting VMs." />

  <Card title="Volumes" href="/volumes/Volumes_list" description="Persistent storage for your Machines." />

  <Card title="Secrets" href="/secrets/Secretkeys_list" description="App secrets and encryption keys." />

  <Card title="TLS Certificates" href="/tls-certificates/App_Certificates_list" description="Certificates for custom hostnames." />

  <Card title="Tokens" href="/tokens/Tokens_authenticate" description="Authenticate and mint access tokens." />
</Cards>