Skip to content

Rev79 Developer Documentation

Welcome to the Rev79 Developer Documentation.

API endpoint

Rev79 offers a GraphQL API endpoint at https://api.rev79.app/graphql.

Example requests

Here is an example HTTP request, which will fetch a list of all the organisations that your token can see, returning the id and name of each organisation.

POST https://api.rev79.app/graphql
Content-type: application/json
Accept: application/json
Authorization: HMAC-SHA256 # (1)!

{"query": "{ organisations { id name } }"}
  1. See Authentication for details of how to populate this header

Here is an example that requests only the organisations that your token can see that have "abc" in their name (case-insensitively).

POST https://api.rev79.app/graphql
Content-type: application/json
Accept: application/json
Authorization: HMAC-SHA256 # (1)!

{
  "query": "query Q($filter: MangoSelector!){ organisations(query: { selector: $filter }) { id name } }",
  "variables": {
    "filter": {
      "name": {
        "$regex": "abc"
      }
    }
  }
}

For more details on this query syntax, see Mango Queries.

Getting Help

This API is still fairly new, and is under active development. While we endeavour not to break any existing functionality, there may be things missing and/or things may not work as well as we'd like. If you run into any issues, please get in touch with us so we can work together to resolve your problem.

If you're reporting a particular request that doesn't work (that you expect should work), please also send us:

  1. the API key you are using (not the secret),
  2. the GraphQL query you're running,
  3. the variables you're sending with your query, and
  4. an explanation of what you're expecting the request to do/return.