To explore and test queries, connections, data types, and mutations in our API you can browse it via a tool called GraphiQL. GraphiQL is a web-based tool that is also available for download as a standalone application on platforms like MacOS, and Linux.
With the GraphiQL tool you can:
GraphiQL is in essence a web-based application that you can install yourself. However, the easiest way to install and use GraphiQL is by using a wrapper package for your operating system here: https://www.electronjs.org/apps/graphiql
Once you've installed GraphiQL, you can connect it to the Firmhouse API endpoint and explore the documentation or perform actual calls against the data in your projects.
First, open GraphiQL and enter the following URL in the GraphQL Endpoint field: https://portal.firmhouse.com/graphql
Once you've entered the Firmhouse API endpoint you will notice the following response in the right pane of the GraphiQL interface:
Don't worry, this is because you haven't added any Project Access Tokens in your GraphiQL client yet.
Generate or find a Project Access Token in your Firmhouse project under the Integrations page from the project Settings menu. Then in GraphiQL, open the HTTP Header configurations via the blue Edit HTTP Headers button and add a header with:
Header Name: X-PROJECT-ACCESS-TOKEN
Header Value: <Your Project Access Token>
Now close the Edit HTTP Headers screen in GraphiQL and open the Documentation Explorer sidepane by clicking < Docs in GraphiQL:
You can then use the Documentation Explorer pane in GraphiQL to explore all possible queries, mutations, connections, and data types of the Firmhouse API:
Can't get GraphiQL to work? Having troubles authenticating with your project? No worries! Our development team is here to support anyone who is exploring or using our API.
Please review the Developer Support page for contact options.