Admin
Read Settings
Get the current Prefect REST API settings.
Secret setting values will be obfuscated.
GET
/
api
/
admin
/
settings
Headers
x-prefect-api-version
string
Response
200 - application/json
PREFECT_HOME
string
default: ~/.prefectPREFECT_DEBUG_MODE
boolean
default: falsePREFECT_CLI_COLORS
boolean
default: truePREFECT_CLI_PROMPT
boolean | null
PREFECT_CLI_WRAP_LINES
boolean
default: truePREFECT_TEST_MODE
boolean
default: falsePREFECT_UNIT_TEST_MODE
boolean
default: falsePREFECT_UNIT_TEST_LOOP_DEBUG
boolean
default: truePREFECT_TEST_SETTING
any
PREFECT_API_TLS_INSECURE_SKIP_VERIFY
boolean
default: falsePREFECT_API_SSL_CERT_FILE
string | null
PREFECT_API_URL
string | null
PREFECT_SILENCE_API_URL_MISCONFIGURATION
boolean
default: falsePREFECT_API_KEY
string | null
PREFECT_API_ENABLE_HTTP2
boolean
default: falsePREFECT_CLIENT_MAX_RETRIES
integer
default: 5PREFECT_CLIENT_RETRY_JITTER_FACTOR
number
default: 0.2PREFECT_CLIENT_RETRY_EXTRA_CODES
string
default: PREFECT_CLIENT_CSRF_SUPPORT_ENABLED
boolean
default: truePREFECT_CLOUD_API_URL
string
default: https://api.prefect.cloud/apiPREFECT_UI_URL
string | null
PREFECT_CLOUD_UI_URL
string | null
PREFECT_API_REQUEST_TIMEOUT
number
default: 60PREFECT_EXPERIMENTAL_WARN
boolean
default: truePREFECT_PROFILES_PATH
string
default: ${PREFECT_HOME}/profiles.tomlPREFECT_RESULTS_DEFAULT_SERIALIZER
string
default: picklePREFECT_RESULTS_PERSIST_BY_DEFAULT
boolean
default: falsePREFECT_TASKS_REFRESH_CACHE
boolean
default: falsePREFECT_TASK_DEFAULT_RETRIES
integer
default: 0PREFECT_FLOW_DEFAULT_RETRIES
integer
default: 0PREFECT_FLOW_DEFAULT_RETRY_DELAY_SECONDS
default: 0
PREFECT_TASK_DEFAULT_RETRY_DELAY_SECONDS
default: 0
PREFECT_TASK_RUN_TAG_CONCURRENCY_SLOT_WAIT_SECONDS
integer
default: 30PREFECT_LOCAL_STORAGE_PATH
string
default: ${PREFECT_HOME}/storagePREFECT_MEMO_STORE_PATH
string
default: ${PREFECT_HOME}/memo_store.tomlPREFECT_MEMOIZE_BLOCK_AUTO_REGISTRATION
boolean
default: truePREFECT_LOGGING_LEVEL
string
default: INFOPREFECT_LOGGING_INTERNAL_LEVEL
string
default: ERRORPREFECT_LOGGING_SERVER_LEVEL
string
default: WARNINGPREFECT_LOGGING_SETTINGS_PATH
string
default: ${PREFECT_HOME}/logging.ymlPREFECT_LOGGING_EXTRA_LOGGERS
string
default: PREFECT_LOGGING_LOG_PRINTS
boolean
default: falsePREFECT_LOGGING_TO_API_ENABLED
boolean
default: truePREFECT_LOGGING_TO_API_BATCH_INTERVAL
number
default: 2PREFECT_LOGGING_TO_API_BATCH_SIZE
integer
default: 4000000PREFECT_LOGGING_TO_API_MAX_LOG_SIZE
integer
default: 1000000PREFECT_LOGGING_TO_API_WHEN_MISSING_FLOW
enum<string>
default: warnAvailable options:
warn
, error
, ignore
PREFECT_SQLALCHEMY_POOL_SIZE
integer | null
PREFECT_SQLALCHEMY_MAX_OVERFLOW
integer | null
PREFECT_LOGGING_COLORS
boolean
default: truePREFECT_LOGGING_MARKUP
boolean
default: falsePREFECT_ASYNC_FETCH_STATE_RESULT
boolean
default: falsePREFECT_API_BLOCKS_REGISTER_ON_START
boolean
default: truePREFECT_API_DATABASE_CONNECTION_URL
string | null
PREFECT_API_DATABASE_DRIVER
enum<string> | null
Available options:
postgresql+asyncpg
, sqlite+aiosqlite
PREFECT_API_DATABASE_HOST
string | null
PREFECT_API_DATABASE_PORT
integer | null
PREFECT_API_DATABASE_USER
string | null
PREFECT_API_DATABASE_NAME
string | null
PREFECT_API_DATABASE_PASSWORD
string | null
PREFECT_API_DATABASE_ECHO
boolean
default: falsePREFECT_API_DATABASE_MIGRATE_ON_START
boolean
default: truePREFECT_API_DATABASE_TIMEOUT
number | null
default: 10PREFECT_API_DATABASE_CONNECTION_TIMEOUT
number | null
default: 5PREFECT_API_SERVICES_SCHEDULER_LOOP_SECONDS
number
default: 60PREFECT_API_SERVICES_SCHEDULER_DEPLOYMENT_BATCH_SIZE
integer
default: 100PREFECT_API_SERVICES_SCHEDULER_MAX_RUNS
integer
default: 100PREFECT_API_SERVICES_SCHEDULER_MIN_RUNS
integer
default: 3PREFECT_API_SERVICES_SCHEDULER_MAX_SCHEDULED_TIME
string
default: P100DPREFECT_API_SERVICES_SCHEDULER_MIN_SCHEDULED_TIME
string
default: PT1HPREFECT_API_SERVICES_SCHEDULER_INSERT_BATCH_SIZE
integer
default: 500PREFECT_API_SERVICES_LATE_RUNS_LOOP_SECONDS
number
default: 5PREFECT_API_SERVICES_LATE_RUNS_AFTER_SECONDS
string
default: PT15SPREFECT_API_SERVICES_PAUSE_EXPIRATIONS_LOOP_SECONDS
number
default: 5PREFECT_API_SERVICES_CANCELLATION_CLEANUP_LOOP_SECONDS
number
default: 20PREFECT_API_SERVICES_FOREMAN_ENABLED
boolean
default: truePREFECT_API_SERVICES_FOREMAN_LOOP_SECONDS
number
default: 15PREFECT_API_SERVICES_FOREMAN_INACTIVITY_HEARTBEAT_MULTIPLE
integer
default: 3PREFECT_API_SERVICES_FOREMAN_FALLBACK_HEARTBEAT_INTERVAL_SECONDS
integer
default: 30PREFECT_API_SERVICES_FOREMAN_DEPLOYMENT_LAST_POLLED_TIMEOUT_SECONDS
integer
default: 60PREFECT_API_SERVICES_FOREMAN_WORK_QUEUE_LAST_POLLED_TIMEOUT_SECONDS
integer
default: 60PREFECT_API_LOG_RETRYABLE_ERRORS
boolean
default: falsePREFECT_API_SERVICES_TASK_RUN_RECORDER_ENABLED
boolean
default: truePREFECT_API_DEFAULT_LIMIT
integer
default: 200PREFECT_SERVER_API_HOST
string
default: 127.0.0.1PREFECT_SERVER_API_PORT
integer
default: 4200PREFECT_SERVER_API_KEEPALIVE_TIMEOUT
integer
default: 5PREFECT_SERVER_CSRF_PROTECTION_ENABLED
boolean
default: falsePREFECT_SERVER_CSRF_TOKEN_EXPIRATION
string
default: PT1HPREFECT_SERVER_CORS_ALLOWED_ORIGINS
string
default: *PREFECT_SERVER_CORS_ALLOWED_METHODS
string
default: *PREFECT_SERVER_CORS_ALLOWED_HEADERS
string
default: *PREFECT_SERVER_ALLOW_EPHEMERAL_MODE
boolean
default: falsePREFECT_SERVER_EPHEMERAL_STARTUP_TIMEOUT_SECONDS
integer
default: 10PREFECT_UI_ENABLED
boolean
default: truePREFECT_UI_API_URL
string | null
PREFECT_SERVER_ANALYTICS_ENABLED
boolean
default: truePREFECT_API_SERVICES_SCHEDULER_ENABLED
boolean
default: truePREFECT_API_SERVICES_LATE_RUNS_ENABLED
boolean
default: truePREFECT_API_SERVICES_FLOW_RUN_NOTIFICATIONS_ENABLED
boolean
default: truePREFECT_API_SERVICES_PAUSE_EXPIRATIONS_ENABLED
boolean
default: truePREFECT_API_TASK_CACHE_KEY_MAX_LENGTH
integer
default: 2000PREFECT_API_SERVICES_CANCELLATION_CLEANUP_ENABLED
boolean
default: truePREFECT_API_MAX_FLOW_RUN_GRAPH_NODES
integer
default: 10000PREFECT_API_MAX_FLOW_RUN_GRAPH_ARTIFACTS
integer
default: 10000PREFECT_RUNNER_PROCESS_LIMIT
integer
default: 5PREFECT_RUNNER_POLL_FREQUENCY
integer
default: 10PREFECT_RUNNER_SERVER_MISSED_POLLS_TOLERANCE
integer
default: 2PREFECT_RUNNER_SERVER_HOST
string
default: localhostPREFECT_RUNNER_SERVER_PORT
integer
default: 8080PREFECT_RUNNER_SERVER_LOG_LEVEL
string
default: errorPREFECT_RUNNER_SERVER_ENABLE
boolean
default: falsePREFECT_DEPLOYMENT_SCHEDULE_MAX_SCHEDULED_RUNS
integer
default: 50PREFECT_WORKER_HEARTBEAT_SECONDS
number
default: 30PREFECT_WORKER_QUERY_SECONDS
number
default: 10PREFECT_WORKER_PREFETCH_SECONDS
number
default: 10PREFECT_WORKER_WEBSERVER_HOST
string
default: 0.0.0.0PREFECT_WORKER_WEBSERVER_PORT
integer
default: 8080PREFECT_TASK_SCHEDULING_DEFAULT_STORAGE_BLOCK
string | null
PREFECT_TASK_SCHEDULING_DELETE_FAILED_SUBMISSIONS
boolean
default: truePREFECT_TASK_SCHEDULING_MAX_SCHEDULED_QUEUE_SIZE
integer
default: 1000PREFECT_TASK_SCHEDULING_MAX_RETRY_QUEUE_SIZE
integer
default: 100PREFECT_TASK_SCHEDULING_PENDING_TASK_TIMEOUT
string
default: PT0SPREFECT_EXPERIMENTAL_ENABLE_SCHEDULE_CONCURRENCY
boolean
default: falsePREFECT_DEFAULT_RESULT_STORAGE_BLOCK
string | null
PREFECT_DEFAULT_WORK_POOL_NAME
string | null
PREFECT_DEFAULT_DOCKER_BUILD_NAMESPACE
string | null
PREFECT_UI_SERVE_BASE
string
default: /PREFECT_UI_STATIC_DIRECTORY
string | null
PREFECT_MESSAGING_BROKER
string
default: prefect.server.utilities.messaging.memoryPREFECT_MESSAGING_CACHE
string
default: prefect.server.utilities.messaging.memoryPREFECT_EVENTS_MAXIMUM_LABELS_PER_RESOURCE
integer
default: 500PREFECT_EVENTS_MAXIMUM_RELATED_RESOURCES
integer
default: 500PREFECT_EVENTS_MAXIMUM_SIZE_BYTES
integer
default: 1500000PREFECT_API_SERVICES_TRIGGERS_ENABLED
boolean
default: truePREFECT_EVENTS_EXPIRED_BUCKET_BUFFER
string
default: PT1MPREFECT_EVENTS_PROACTIVE_GRANULARITY
string
default: PT5SPREFECT_API_SERVICES_EVENT_PERSISTER_ENABLED
boolean
default: truePREFECT_API_SERVICES_EVENT_PERSISTER_BATCH_SIZE
integer
default: 20PREFECT_API_SERVICES_EVENT_PERSISTER_FLUSH_INTERVAL
number
default: 5PREFECT_EVENTS_RETENTION_PERIOD
string
default: P7DPREFECT_API_EVENTS_STREAM_OUT_ENABLED
boolean
default: truePREFECT_API_EVENTS_RELATED_RESOURCE_CACHE_TTL
string
default: PT5MPREFECT_EVENTS_MAXIMUM_WEBSOCKET_BACKFILL
string
default: PT15MPREFECT_EVENTS_WEBSOCKET_BACKFILL_PAGE_SIZE
integer
default: 250PREFECT_API_ENABLE_METRICS
boolean
default: falsePREFECT_CLIENT_ENABLE_METRICS
boolean
default: falsePREFECT_CLIENT_METRICS_PORT
integer
default: 4201Was this page helpful?