Skip to content

The Immuta API

Undocumented API endpoints and attributes

Any endpoints or attributes that are not documented are for internal purposes and should not be used.

Integrations API

The integrations API allows you to integrate your remote data platform with Immuta so that Immuta can manage and enforce access controls on your data.

Version 2 Immuta API

Version 2 of the Immuta API allows data engineers to manage their data sources, projects, and policies as code, providing a way to track, approve, and easily update data sources and their associated policies.

The benefits of the V2 API are outlined below:

  • Reduces complexity: The data source API has been simplified to only require the connection information in most instances and one endpoint for all database technologies.

  • Maintains less state: Whether updating or creating, the same endpoint is used, and the same data is passed. No IDs are required, so no additional state is required.

  • Requires fewer steps: Only an API key is required; no additional authentication step is required before using the API.

  • Integrates with Git: Define data sources and policies in files that can be tracked in Git and easily pushed to Immuta. Both JSON and YAML are supported for more flexibility. (For example, use YAML to add comments in files.)

Version 1 Immuta API

Version 1 of the Immuta API is still supported and can be accessed through the Immuta CLI. However, users are encouraged to use Version 2 of Immuta's API because of all the benefits outlined above.