prefect 2.83.1 published on Tuesday, Jul 22, 2025 by prefecthq
Prefect Provider
Generate Provider
The Prefect provider must be installed as a Local Package by following the instructions for Any Terraform Provider:
pulumi package add terraform-provider prefecthq/prefect
Overview
Use the Prefect provider to configure your Prefect infrastructure.
The provider supports both Prefect Cloud and Prefect OSS.
The provider is tested against Prefect 3 and later. There is no compatibility guarantee for Prefect 2.
See getting started for more information on setting up the provider.
See troubleshoting for resources to address potential errors.
Configuration Reference
accountId(String) Default Prefect Cloud Account ID. Can also be set via thePREFECT_CLOUD_ACCOUNT_IDenvironment variable.apiKey(String, Sensitive) Prefect Cloud API key. Can also be set via thePREFECT_API_KEYenvironment variable.basicAuthKey(String, Sensitive) Prefect basic auth key. Can also be set via thePREFECT_BASIC_AUTH_KEYenvironment variable.csrfEnabled(Boolean) Enable CSRF protection for API requests. Defaults to false. If enabled, the provider will fetch a CSRF token from the Prefect API and include it in all requests. This should be enabled if your Prefect server instance has CSRF protection active. Can also be set via thePREFECT_CSRF_ENABLEDenvironment variable.endpoint(String) The Prefect API URL. Can also be set via thePREFECT_API_URLenvironment variable. Defaults tohttps://api.prefect.cloudif not configured. Can optionally include the default account ID and workspace ID in the following format:https://api.prefect.cloud/api/accounts/<accountID>/workspaces/<workspaceID>. This is the same format used for thePREFECT_API_URLvalue in the Prefect CLI configuration file. TheaccountIdandworkspaceIdattributes and their matching environment variables will take priority over any account and workspace ID values provided in theendpointattribute.workspaceId(String) Default Prefect Cloud Workspace ID.