Download the Bevy OpenAPI JSON from Bevy API Reference, import it into Postman as a collection, then set baseUrl and apiKey so you can send authenticated requests. Importing the spec does not store a working token and does not run any requests for you.

Postman can turn the Bevy public API OpenAPI JSON into a request collection. Use this when you want to explore endpoints locally before you build an integration. For base URL, authentication, versioning, and rate limits, see Using Public Bevy APIs. Endpoint details stay in Bevy API Reference.

Download the OpenAPI JSON

1. Open Bevy API Reference.
2. Use Download on that page (the download control on the API reference viewer, not a file attached in the Guide article body).
3. Save the openapi.json file on your computer.

Import the spec as a Postman collection

1. In Postman, select Import.
2. Upload the OpenAPI JSON file you downloaded.
3. Review the import options, then choose to generate a collection from the spec.
4. Finish the import.

You should see the imported collection in Collections. Postman may also keep an API definition from the same file. Label names can vary slightly by Postman version; use the collection that lists the Bevy public API operations.

Set baseUrl and apiKey

Open the imported collection, then open its Variables tab. Set at least:

• baseUrl — your community base URL plus /api. Example: https://your-community.example/api.
• apiKey — the Authorization header value: the word Token, a space, then your Bevy API key. Example: Token your-api-key-here.

Get or reset the key in Manage your Bevy API key. Only HQ administrators can view and reset that key. After you save the variables, open a request in the collection, confirm it uses those variables, and send it when you are ready to test.