Managing Permissions for Integrations | Vercel
Integration permissions restrict the API surface the integration is allowed to access. Learn more about managing permissions for integrations here.Integration permissions restrict the API surface the integration is allowed to access. When you install an integration, you will see an overview of what permissions the integration requires to work.
Permission Type | Read Access | Write Access |
|---|---|---|
Installation | Reads whether the integration is installed for the hobby or team account | Removes the installation for the hobby or team account |
Deployment | Retrieves deployments for the hobby or team account. Includes build logs, a list of files and builds, and the file structure for a specific deployment | Creates, updates, and deletes deployments for the hobby or team account |
Deployment Checks | N/A | Retrieves, creates, and updates tests/assertions that trigger after deployments for the hobby or team account |
Project | Retrieves projects for the hobby or team account. Also includes retrieving all domains for an individual project | Creates, updates, and deletes projects for the hobby or team account |
Project Environment Variables | N/A | Reads, creates, and updates integration-owned environment variables for the hobby or team account |
Global Project Environment Variables | N/A | Reads, creates, and updates all environment variables for the hobby or team account |
Team | Accesses team details for the account. Includes listing team members | N/A |
Current User | Accesses information about the hobby account on which the integration is installed | N/A |
Log Drains | N/A | Retrieves a list of log drains, creates new and removes existing ones for the hobby or team account |
Domain | Retrieves all domains for the hobby or team account. Includes reading its status and configuration | Removes a previously registered domain name from Vercel for the hobby or team account |
Integrations can request more permissions over time. Individual users and team owners will get notified if an integration installation has pending permission changes, and will also see a pending review indicator on the Vercel Dashboard.
The user or team can review and approve every permission change. Every permission request will contain a note from the integrator with further details on why this change is necessary. Confirming permission changes ensures that the integration has the right access and can use upcoming and new features of the Vercel platform to support your daily work.
