API Reference

Introduction

Hasura Cloud provides a GraphQL API to interact with the services to create and manage your projects.

You can use any GraphQL client and use the API with the right authentication header.

Endpoint

API endpoint is https://data.pro.hasura.io/v1/graphql.

Authentication

Authentication is done using a Personal Access Token that you can create from the Hasura Cloud Dashboard. You can find this option in the “My Account” section on bottom left.

Once you have the token it can be used with the header: Authorization: pat <token>.

Note

This token can be used to authenticate against Hasura Cloud APIs and your Hasura Cloud projects. Make sure you keep it secure. The token will be valid until you delete it from the dashboard.

APIs

Each Hasura Cloud project is backed by an API entity called “Tenant”, with a distinct “Tenant ID” which is different from “Project ID”. Each Project is associated with a Tenant. In some cases, like Metrics API, the Project ID is used instead of Tenant ID.

List of some useful APIs:

Create a Project

mutation createProject {
  createTenant(
    cloud: "aws"
    region: "us-east-2"
    envs: [{
      key: "HASURA_GRAPHQL_CORS_DOMAIN",
      value: "*"
    }, {
      key: "MY_ENV_VAR_1",
      value: "my value 1"
    }]
  ) {
    id
    name
  }
}

Get Project tenant id

query getProjectTenantId {
  projects_by_pk(
    id: "7a79cf94-0e53-4520-a560-1b02bf522f08"
  ) {
    id
    tenant {
      id
    }
  }
}

Get Tenant details

query getTenantDetails {
  tenant_by_pk(
    id: "7a79cf94-0e53-4520-a560-1b02bf522f08"
  ) {
    id
    slug
    project {
      id
      endpoint
    }
  }
}

Delete a Tenant

mutation deleteTenant {
  deleteTenant(
    tenantId: "7a79cf94-0e53-4520-a560-1b02bf522f08"
  ) {
    status
  }
}

Get ENV Vars

query getTenantENV {
  getTenantEnv(
    tenantId: "7a79cf94-0e53-4520-a560-1b02bf522f08"
  ) {
    hash
    envVars
  }
}

Update ENV Vars

mutation updateTenantEnv {
  updateTenantEnv(
    tenantId: "7a79cf94-0e53-4520-a560-1b02bf522f08"
    currentHash: "6902a395d70072fbf8d36288f0eacc36c9d82e68"
    envs: [
      {key: "HASURA_GRAPHQL_ENABLE_CONSOLE", value: "true"},
      {key: "ACTIONS_ENDPOINT", value: "https://my-actions-endpoint.com/actions"}
    ]
  ) {
    hash
    envVars
  }
}

Create GitHub Preview App

Schedules the creation of a Hasura Cloud project with metadata and migrations from a branch of a GitHub repo.

mutation createGitHubPreviewApp {
  createGitHubPreviewApp (
    payload: {
      githubPersonalAccessToken: "<github_access_token>",
      githubRepoDetails: {
          branch: "main"
          owner: "my-org"
          repo: "my-repo",
          directory: "backend/hasura"
      },
      projectOptions: {
        cloud: "aws",
        region: "us-east-2",
        plan: "cloud_free",
        name: "my-app_name"
        envVars: [{
          key: "HASURA_GRAPHQL_AUTH_HOOK",
          value: "https://my-webhook.com"
        }, {
          key: "MY_ENV_VAR_1",
          value: "my value 1"
        }]
      }
    }
  ) {
    githubPreviewAppJobID # job ID of the preview app creation job
  }
}
« previous | next »
Want to contribute or report missing content?

Powered by Sphinx. | Copyright © 2021 Hasura.