Read Variables

Headers

x-prefect-api-version

string

Body

application/json

limit

integer

Defaults to PREFECT_API_DEFAULT_LIMIT if not provided.

offset

integer

default:

0

Required range: x > 0

sort

enum<string>

Defines variables sorting options.

Available options:

CREATED_DESC,

UPDATED_DESC,

NAME_DESC,

NAME_ASC

variables

object | null

Filter variables. Only variables matching all criteria will be returned

Show child attributes

variables.id

object | null

Filter criteria for Variable.id

Show child attributes

variables.id.any_

string[] | null

A list of variable ids to include

variables.name

object | null

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 _.

variables.operator

enum<string>

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

Available options:

and_,

or_

variables.tags

object | null

Filter criteria for Variable.tags

Show child attributes

variables.tags.all_

string[] | null

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

variables.tags.is_null_

boolean | null

If true, only include Variables without tags

variables.tags.operator

enum<string>

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

Available options:

and_,

or_

Response

200 - application/json

created

string | null

required

id

string

required

name

string

required

The name of the variable

Maximum length: 255

updated

string | null

required

value

required

The value of the variable

tags

string[]

A list of variable tags