Docs
Reference

Prefect Cloud

Secret blocks in one Prefect Cloud workspace.

Secret blocks in one Prefect Cloud workspace.

The connection

WhatThis provider
VendorPrefect
Keyprefect-block-secret
Availabilityavailable. You can connect it today.
Credential penv holdsprefect-key
Values read backyes
Activationimmediate

What it moves

DirectionWhat it does
importReads names and values out of the store into penv.
exportWrites names and values from penv into the store.

When a written value goes live

immediate. The running app sees a new value at once.

What happens to a name that exists

DirectionPolicies you can pick
importskip_existing, new_version, fail
exportcreate_only, overwrite, overwrite_and_prune

How syncs work says what each one does.

How you connect

You paste a credential you already hold. penv seals it and never shows it again.

FieldLabelKindRequiredWhat it is
apiKeyAPI keysecret, masked here and sealedyesAn account or workspace API key. A service account key survives the person who made it.

What the connection asks for

Fixed when you connect, and shared by every mapping on it.

FieldLabelKindRequiredAdvancedWhat it is
accountIdAccount IDtextyesnoThe first ID in your Prefect Cloud URL, after /account/.
workspaceIdWorkspace IDtextyesnoThe second ID in the same URL, after /workspace/.

What a mapping asks for

Answered once per environment you map.

FieldLabelKindRequiredAdvancedWhat it is
namePrefixBlock name prefixtextyesnoA workspace holds every block in one list, so the prefix is what this sync owns.

Permissions it needs

penv probes for these when it verifies the connection.

PermissionDirectionsBlockingWithout it
Workspace Viewerevery directionyesPreview cannot list the Secret blocks in this workspace.
Workspace DeveloperexportyesExport cannot write anything.