GraphQL API
Last updated
Was this helpful?
Last updated
Was this helpful?
provides for fetching data and a set of for modifying objects.
The GraphQL endpoint can be found at https://toil.kitemaker.co/developers/graphql
. is enabled for this endpoint, so you can point your favorite GraphQL developer tool (like or ) at the API to retrieve the schema and interact with the API. Please note: even introspecting the API requires the client to be authenticated.
Authentication currently based on a simple Bearer token scheme. When making any request to the server, set the Authorization
HTTP header:
There are currently two token types:
Personal access tokens - these tokens operate on the API as a particular user (within a single organization)
Application tokens - these tokens operate on the API as their own actor (i.e. a service user within a single organization)
Personal access tokens have access to the same spaces to which their associated user has access. Application tokens only have access to non-private spaces currently.
Tokens are obtained in Kitemaker by searching for "manage developer settings" in the Kitemaker Command or by clicking the cogwheel/settings icons for your organization.
The workItems
query will return limited number of work items. It will also return a boolean called hasMore
and a string called cursor
. When hasMore
is true, you can pass cursor
to the work items query to fetch the next batch of items:
Please note: the cursor
property should be treated as an opaque string. It currently resembles (i.e. actually is) a work item number, but this should not be relied upon.
The annotated schema for the Kitemaker GraphQL API is located here:
If anything in the API is unclear or you find the comments to be lacking, email us at and we'll improve it right away.