Read Variables - Prefect

Headers

x-prefect-api-version

string

Body

application/json

offset

integer

default:0

Required range: x >= 0

variables

VariableFilter · object

Filter variables. Only variables matching all criteria will be returned

Show child attributes

variables.operator

enum<string>

default:and_

Operator for combining filter criteria. Defaults to 'and_'.

Available options:

and_,

or_

variables.id

VariableFilterId · object

Filter criteria for Variable.id

Show child attributes

variables.id.any_

string<uuid>[] | null

A list of variable ids to include

variables.name

VariableFilterName · object

Filter criteria for Variable.name

Show child attributes

variables.name.any_

string[] | null

A list of variables names to include

variables.name.like_

string | null

A string to match variable names against. This can include SQL wildcard characters like % and _.

Example:

"my_variable_%"

variables.tags

VariableFilterTags · object

Filter criteria for Variable.tags

Show child attributes

variables.tags.operator

enum<string>

default:and_

Operator for combining filter criteria. Defaults to 'and_'.

Available options:

and_,

or_

variables.tags.all_

string[] | null

A list of tags. Variables will be returned only if their tags are a superset of the list

Example:

["tag-1", "tag-2"]

variables.tags.is_null_

boolean | null

If true, only include Variables without tags

sort

enum<string>

default:NAME_ASC

Defines variables sorting options.

Available options:

CREATED_DESC,

UPDATED_DESC,

NAME_DESC,

NAME_ASC

limit

integer

Defaults to PREFECT_API_DEFAULT_LIMIT if not provided.

Response

Successful Response

string<uuid>

required

created

string<date-time> | null

required

updated

string<date-time> | null

required

name

string

required

The name of the variable

Maximum string length: 255

value

required

The value of the variable

Example:

"my-value"

API Reference

Headers

Body

Response