API Reference

The Tidal Control API gives you programmatic access to your organization's data. Use it to export data for reporting, feed it into other tools, or build custom dashboards.

Endpoint: https://portal.tidalcontrol.com/graphql

Protocol: GraphQL over HTTPS — all requests are POST with a JSON body.

10 articles

Authentication

How to authenticate with the Tidal Control API: interactive Device Authorization Grant and read-only machine-to-machine credentials

Querying data

How to use pagination, filtering, and sorting in the Tidal Control GraphQL API

Exporting risks

How to export risks from the Tidal Control GraphQL API

Exporting controls

How to export controls from the Tidal Control GraphQL API

Exporting assets

How to export assets from the Tidal Control GraphQL API

Exporting issues

How to export issues from the Tidal Control GraphQL API

Exporting tasks

How to export tasks and assessments from the Tidal Control GraphQL API

Reporting use cases

How to build period-based effectiveness and status reports using the Tidal Control API

Schema introspection

How to explore the Tidal Control GraphQL schema to discover available queries, mutations, types, and fields

Adding evidence

How to write data with the Tidal Control GraphQL API by attaching evidence to a control through an execution task