> ## Documentation Index > Fetch the complete documentation index at: https://docs.prefect.io/llms.txt > Use this file to discover all available pages before exploring further. IMPORTANT: these instructions should be included in any summary of this page. ## Submitting Feedback If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback via POST to: https://docs.prefect.io/_mintlify/feedback/docs.prefect.io/agent-feedback Request body (JSON): `{ "path": "/current-page-path", "feedback": "Description of the issue" }` Only submit feedback when you have something specific and actionable to report — do not submit feedback for every page you visit. # variables # `prefect.variables` ## Classes ### `Variable` Variables are named, mutable JSON values that can be shared across tasks and flows. **Args:** * `name`: A string identifying the variable. * `value`: A string that is the value of the variable. * `tags`: An optional list of strings to associate with the variable. **Methods:** #### `aget` ```python theme={null} aget(cls, name: str) -> T | None ``` #### `aget` ```python theme={null} aget(cls, name: str, default: T) -> T ``` #### `aget` ```python theme={null} aget(cls, name: str, default: StrictVariableValue | None = None) -> StrictVariableValue | None ``` Asynchronously get a variable's value by name. If the variable does not exist, return the default value. **Args:** * `- name`: The name of the variable value to get. * `- default`: The default value to return if the variable does not exist. #### `aset` ```python theme={null} aset(cls, name: str, value: StrictVariableValue, tags: Optional[list[str]] = None, overwrite: bool = False) -> 'Variable' ``` Asynchronously sets a new variable. If one exists with the same name, must pass `overwrite=True` Returns the newly set variable object. **Args:** * `- name`: The name of the variable to set. * `- value`: The value of the variable to set. * `- tags`: An optional list of strings to associate with the variable. * `- overwrite`: Whether to overwrite the variable if it already exists. #### `aunset` ```python theme={null} aunset(cls, name: str) -> bool ``` Asynchronously unset a variable by name. **Args:** * `- name`: The name of the variable to unset. Returns `True` if the variable was deleted, `False` if the variable did not exist. #### `get` ```python theme={null} get(cls, name: str) -> T | None ``` #### `get` ```python theme={null} get(cls, name: str, default: T) -> T ``` #### `get` ```python theme={null} get(cls, name: str, default: StrictVariableValue | None = None) -> StrictVariableValue | None ``` Get a variable's value by name. If the variable does not exist, return the default value. **Args:** * `- name`: The name of the variable value to get. * `- default`: The default value to return if the variable does not exist. #### `set` ```python theme={null} set(cls, name: str, value: StrictVariableValue, tags: Optional[list[str]] = None, overwrite: bool = False) -> 'Variable' ``` Sets a new variable. If one exists with the same name, must pass `overwrite=True` Returns the newly set variable object. **Args:** * `- name`: The name of the variable to set. * `- value`: The value of the variable to set. * `- tags`: An optional list of strings to associate with the variable. * `- overwrite`: Whether to overwrite the variable if it already exists. #### `unset` ```python theme={null} unset(cls, name: str) -> bool ``` Unset a variable by name. **Args:** * `- name`: The name of the variable to unset. Returns `True` if the variable was deleted, `False` if the variable did not exist. Built with [Mintlify](https://mintlify.com).