--- title: Tools and downloads description: The OpenAPI file, the Postman collection and the GraphQL schema for the Coevera API, your space's own OpenAPI document, and how to use them in Postman and Insomnia. canonical: https://developers.coevera.com/get-started/tools/ section: get-started verification: behaviour lastVerified: 2026-10-16 publisher: Coevera --- # Tools and downloads **Answer:** The API reference offers an OpenAPI 3.1 file with Coevera hosts, a Postman collection with a Coevera environment, and the public GraphQL schema as SDL. Your space's own OpenAPI document, with its custom fields, is openapi.json under your REST base URL and needs your credentials. Postman imports the collection; Insomnia imports the OpenAPI file. There is no SDK. You can call the API from any HTTP client. These files save typing: they describe every operation, and the Postman collection is ready to send once you fill in your credentials. ## The downloads The REST reference's [Downloads](/reference/downloads/) page offers the OpenAPI file and the Postman collection, and the [GraphQL overview](/reference/graphql/) the schema as SDL, all built from the same pinned contract as the reference itself: | File | What it holds | Use it in | | -------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------- | | [OpenAPI 3.1 (JSON)](/openapi/coevera-rest.json) | Every REST operation, with the Coevera hosts as `{region}` and `{space_id}` server variables, the Basic security scheme, and the errors the API really returns | Insomnia, code generators, linters, AI tools | | Postman [collection](/postman/coevera-rest.postman_collection.json) and [environment](/postman/coevera.postman_environment.json) | Every REST operation, in folders by entity family, with Basic auth from the environment. The environment, **Coevera**, has the variables `region`, `space_id`, `key` and `secret`; `key` and `secret` ship empty. | Postman, Insomnia | | [GraphQL schema (SDL)](/graphql/schema.graphql) | The public GraphQL schema for integrators | Code generation, editor autocomplete, linting | Every build validates the OpenAPI file with Scalar's OpenAPI parser and stops on any error. The collection follows Postman's collection format v2.1.0, and the SDL is printed by graphql-js from the public schema. These files describe the standard data model. Custom entities appear under one generic path, `/entities/{custom_entity_api_name}`, and your custom fields are only in your space's own document. ## Your space's own documents Two documents come from the API itself, for your space: ```text https://{region}.api.coevera.com/api/v100/rest/spaces/{space_id}/openapi.json https://{region}.api.coevera.com/api/v100/app/space/{space_id}/graphql/public/schema.json ``` - **`openapi.json`** is built for your space: its entities carry your custom fields. It needs the same Basic credentials as any API call and answers `401` without them. Its `servers` list hosts on the former domain; call `https://{region}.api.coevera.com` instead. - **`schema.json`** is the public GraphQL schema as an introspection result, in JSON. It needs no credentials. The [discovery endpoint](/get-started/regions-and-base-urls/#find-a-spaces-region) returns both URLs for a space. ## Postman 1. Download the [collection](/postman/coevera-rest.postman_collection.json) and the [environment](/postman/coevera.postman_environment.json) from the [downloads](/reference/downloads/#postman). 2. In your Postman workspace, click **Use resources or import**, then **Import**, and select both files. 3. Select the **Coevera** environment and fill in `region`, `space_id`, `key` (the application's **User Name**) and `secret` (its **Password**). `key` and `secret` are secret variables; do not share or export the environment with them filled in. 4. Send any request in the collection: it takes Basic auth from `key` and `secret`, and its base URL from `region` and `space_id`. The menu names are those of [Postman's import documentation](https://learning.postman.com/docs/getting-started/importing-and-exporting/importing-data/). ## Insomnia In your Insomnia workspace, click **Import**, choose **File**, select the OpenAPI file or the Postman collection, click **Scan**, then **Import**. Insomnia imports OpenAPI 3.0 and 3.1 and Postman collections v2.0 and v2.1. An imported OpenAPI file opens as a spec: click **Generate** and choose **Requests** to get requests you can send. Then set the auth to Basic with the application's **User Name** and **Password**, and set the base URL to your region and space. The steps and formats are those of Kong's Insomnia documentation, [import an API spec](https://developer.konghq.com/how-to/import-an-api-spec/) and [import and export](https://developer.konghq.com/insomnia/import-export/). ## GraphQL clients Send `POST` requests to your space's GraphQL endpoint with Basic auth, as in the [quickstart](/get-started/quickstart/). Load the schema from the SDL download or from your space's `schema.json` for autocomplete. ## Limits - Coevera publishes no SDK. Generate a client from the OpenAPI file, or call the API over plain HTTP as the samples on this site do. - This site has no console for sending requests; use Postman, Insomnia or the samples. - The import steps follow the Postman and Insomnia documentation. The files were validated against the formats those apps import, not imported in the apps themselves.