https://github.com/comfortablycoding/bruno-directus
Comprehensive Bruno collection covering the entire Directus API surface: REST, GraphQL, and WebSockets.
https://github.com/comfortablycoding/bruno-directus
Last synced: 24 days ago
JSON representation
Comprehensive Bruno collection covering the entire Directus API surface: REST, GraphQL, and WebSockets.
- Host: GitHub
- URL: https://github.com/comfortablycoding/bruno-directus
- Owner: ComfortablyCoding
- License: mit
- Created: 2026-03-22T06:59:35.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-03-23T14:51:59.000Z (about 1 month ago)
- Last Synced: 2026-04-04T07:59:58.347Z (24 days ago)
- Size: 108 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Directus API — Bruno Collection
Comprehensive Bruno collection covering the entire Directus 11+ API surface: REST, GraphQL, and WebSockets.
## Setup
1. Install [Bruno](https://www.usebruno.com/downloads) if you haven't already
2. Clone or download this repository
3. In Bruno, click **Open Collection** (or `Ctrl/Cmd+O`) and select this folder
4. In the top-right environment dropdown, select an environment (see below)
5. Replace the placeholder values in the environment with your Directus instance details
## Environments
| Environment | Purpose | Auth |
| ------------ | -------------------------------------- | ------------------- |
| `local` | Local dev instance at `localhost:8055` | Static user token |
| `production` | Production instance | Static user token |
| `admin` | Admin-level access | Admin static token |
| `public` | Unauthenticated requests | No auth header sent |
### Variables
| Variable | Description |
| -------------- | ------------------------------------------------------------ |
| `base_url` | Directus instance URL (e.g. `http://localhost:8055`) |
| `access_token` | Static access token (leave empty for public/unauthenticated) |
## Authentication
If an `access_token` is defined in the active environment, an `Authorization: Bearer {{access_token}}` header is automatically included. The header is **not** added under the following conditions:
- The request's auth mode is set to `inherit` or `none`
- The request is a WebSocket connection
- The request endpoint is `/auth/login` or `/auth/refresh`
- The `access_token` value is empty in the active environment (e.g. `public`)
- A request level `Authorization` header is set
## Other Tooling
Directus serves its own OpenAPI spec at `/server/specs/oas` — use that for Postman, Insomnia, or any OpenAPI-compatible tool.
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md) for conventions and guidelines.
## Directus Docs
https://directus.io/docs