Skip to main content


Environments are isolated, standalone workspaces that support all of the API and dashboard operations provided by Warrant. Each environment's data (users, roles, permissions, etc.) is separate from that of other environments, making it easy to implement and test changes to the authorization model for an application without impacting the authorization workload of that application in production. By default, all organizations have a production and a test environment and support creation of new environments. Users have the ability to manage which users have access to each environment and what level of access each user has (owner, manager, or member).

Separate environments for development/testing and production are a common practice on most engineering teams as a way to improve team productivity, prevent bugs, and speed up release cycles by giving the team more confidence in the changes being made before releasing a feature to customers. Environments in Warrant are built to work seamlessly with your team's development process by allowing you to create environments that match your team's application environments and workflow. You can then implement and test new access rules in a test or development environment before making the change in production.

Environment Permissions

Environments are only accessible to users who have been granted access to them. Users can have one of two levels of access to an environment: admin or member.

member - Members can view the environment's keys and view or modify the data in the environment via API or Dashboard.

admin - Admins have the abilities of a member and can also modify an environment's name and manage user access to the environment. This includes adding, removing, or editing a user's access to that environment.

The user who created an environment is automatically assigned as an admin of the environment. The user who first created a Warrant organization for their team is automatically assigned as an admin of the default production and test environments.

Getting Started with Environments

To get started with your own custom environments, go to the Account page in the Warrant Dashboard and find the Environments section. This section lists all environments that you have access to within your team's organization.

To create a new environment, click Create Environment and enter an environment ID and a name. By default, each environment will be created with the following:

  • Default object types (Read more)
  • admin role
  • view-self-service-dashboard permission

Once you've created an environment, you can switch to that environment by selecting it in the Environment dropdown in the left nav. Once selected, all actions performed in the dashboard will operate on the selected environment. To make API calls in this environment, use the environment API key listed in the API Keys section of the Account page.

If you're an owner or manager of an environment, you'll see buttons in the Environments section allowing you to manage user access to that environment and edit its name.