Aden McCusker
03/07/2026, 6:11 AMAsk Inkeep
03/07/2026, 6:11 AMAsk Inkeep
03/07/2026, 6:12 AMPDP_API_KEY configuration requires an *Environment-level API Key* specifically. (1)
There are three types of API keys in Permit.io: (2)
• *Organization API Keys* – Can act on your entire Permit workspace and access all projects and environments within that workspace.
• *Project API Keys* – Can access a single project and all environments belonging to that project.
• *Environment API Keys* – Can access a single environment. *Only this type of API key can be used by the PDP container.*
So when configuring your PDP with PDP_API_KEY, you must use an Environment-level key obtained from your specific environment. (1) Ask Inkeep
03/07/2026, 6:12 AMOr Weis
03/07/2026, 6:38 AMAsk Inkeep
03/07/2026, 6:38 AMAsk Inkeep
03/07/2026, 6:38 AMcreate-env API to dynamically create preview environments for deployment as part of your CI/CD pipeline (1)
• Use the copy-env API to merge/promote changes between environments (1) (2)
*Terraform Provider:*
• The Permit Terraform Provider allows you to manage policy schemas as code, integrating policy management directly into your SDLC (3)
• You can version policies, manage branches, and integrate them seamlessly with your CI/CD pipeline
*GitOps:*
• Integration with Git allows merging and enforcing policy changes by managing authorization policies just as you would manage code (1)
• Behind the scenes, Permit creates a Policy as Code repository for each project, and environments are branches in this repository (4)
This approach ensures each PDP is correctly siloed to its intended environment using its unique secret key, while still allowing you to explicitly manage how policies flow between environments. (1) Ask Inkeep
03/07/2026, 6:38 AMOr Weis
03/07/2026, 6:40 AM