This document describes how to use the koppla GraphQL API.
<aside> 💡 This document is shared with people outside of koppla.
</aside>
The live schema of our API can be found here. It’s automatically updated whenever a new schema is released.
The API can be accessed via https://api.koppla.de/api/graphql/v1/
Pass JWT token via Authorization
header of request. The token can be obtained via the web app. The token will grant access to the same resources that your user has.
It’s possible to use the GraphQL API with a permanent API key. The key doesn’t expire and is therefore suitable for custom integrations.
The API key can be restricted to tenants or specific projects.
Tenant access
Tenant access grants read access to tenant memberships and project access for every project of that tenant.
Project access
This type of access grants read permissions to the following data of a project