GraphQL

Humio has chosen GraphQL for our main API because it offers significantly more flexibility for API clients. GraphQL allows you to precisely specify the data you require, which allows you to call a single endpoint to get everything you need. This makes creating integrations and clients for Humio much easier.

The GraphQL API is documented by our interactive API explorer:

https://cloud.humio.com/docs/api-explorer (Requires a Humio Cloud Account) $BASEURL/docs/api-explorer

New to GraphQL?

If you are unfamiliar with GraphQL don’t fret. You don’t need GraphQL special tools to use it. GraphQL is based on HTTP, and all you need is curl to send requests and returns JSON responses.

Industry leaders like:

  • Github
  • Facebook
  • Twitter

have all based their newest APIs on GraphQL.

Resources for Learning GraphQL

API Explorer

Humio has an built-in API explorer bundled with each installation. You can find it under:

http://$HOST:$PORT/docs/api-explorer

There newest version is always available under:

https://cloud.humio.com/docs/api-explorer (Requires a Humio Cloud Account) $BASEURL/docs/api-explorer (for on premise installations)

Why use both GraphQL and REST?

Some resources in Humio must be accessed with REST. This is both for of historical reasons and that we feel that REST is better suited for our Querying API. Also HTTP streaming is more appropriate for our streaming results, though we may add support for GraphQL Subscriptions the future.