Read Block Documents

Headers

x-prefect-api-version

string

Body

application/json

block_documents

BlockDocumentFilter · object

Filter BlockDocuments. Only BlockDocuments matching all criteria will be returned

Show child attributes

block_documents.operator

enum<string>

default:and_

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

Available options:

and_,

or_

block_documents.id

BlockDocumentFilterId · object

Filter criteria for BlockDocument.id

Show child attributes

block_documents.id.any_

string<uuid>[] | null

A list of block ids to include

block_documents.is_anonymous

BlockDocumentFilterIsAnonymous · object

Filter criteria for BlockDocument.is_anonymous. Defaults to excluding anonymous blocks.

Show child attributes

block_documents.is_anonymous.eq_

boolean | null

Filter block documents for only those that are or are not anonymous.

block_documents.block_type_id

BlockDocumentFilterBlockTypeId · object

Filter criteria for BlockDocument.block_type_id

Show child attributes

block_documents.block_type_id.any_

string<uuid>[] | null

A list of block type ids to include

block_documents.name

BlockDocumentFilterName · object

Filter criteria for BlockDocument.name

Show child attributes

block_documents.name.any_

string[] | null

A list of block names to include

block_documents.name.like_

string | null

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

Example:

"my-block%"

block_types

BlockTypeFilter · object

Filter BlockTypes

Show child attributes

block_types.name

BlockTypeFilterName · object

Filter criteria for BlockType.name

Show child attributes

block_types.name.like_

string | null

A case-insensitive partial match. For example, passing 'marvin' will match 'marvin', 'sad-Marvin', and 'marvin-robot'.

Example:

"marvin"

block_types.slug

BlockTypeFilterSlug · object

Filter criteria for BlockType.slug

Show child attributes

block_types.slug.any_

string[] | null

A list of slugs to match

block_schemas

BlockSchemaFilter · object

Filter BlockSchemas

Show child attributes

block_schemas.operator

enum<string>

default:and_

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

Available options:

and_,

or_

block_schemas.block_type_id

BlockSchemaFilterBlockTypeId · object

Filter criteria for BlockSchema.block_type_id

Show child attributes

block_schemas.block_type_id.any_

string<uuid>[] | null

A list of block type ids to include

block_schemas.block_capabilities

BlockSchemaFilterCapabilities · object

Filter criteria for BlockSchema.capabilities

Show child attributes

block_schemas.block_capabilities.all_

string[] | null

A list of block capabilities. Block entities will be returned only if an associated block schema has a superset of the defined capabilities.

Example:

["write-storage", "read-storage"]

block_schemas.id

BlockSchemaFilterId · object

Filter criteria for BlockSchema.id

Show child attributes

block_schemas.id.any_

string<uuid>[] | null

A list of IDs to include

block_schemas.version

BlockSchemaFilterVersion · object

Filter criteria for BlockSchema.version

Show child attributes

block_schemas.version.any_

string[] | null

A list of block schema versions.

Example:

["2.0.0", "2.1.0"]

include_secrets

boolean

default:false

Whether to include sensitive values in the block document.

sort

enum<string> | null

default:NAME_ASC

Defines block document sorting options.

Available options:

NAME_DESC,

NAME_ASC,

BLOCK_TYPE_AND_NAME_ASC

offset

integer

default:0

Required range: x >= 0

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

block_schema_id

string<uuid>

required

A block schema ID

block_type_id

string<uuid>

required

A block type ID

name

string | null

The block document's name. Not required for anonymous block documents.

data

Data · object

The block document's data

block_schema

BlockSchema · object

The associated block schema

Show child attributes

block_schema.id

string<uuid>

required

block_schema.created

string<date-time> | null

required

block_schema.updated

string<date-time> | null

required

block_schema.checksum

string

required

The block schema's unique checksum

block_schema.block_type_id

string<uuid> | null

required

A block type ID

block_schema.fields

Fields · object

The block schema's field schema

block_schema.block_type

BlockType · object

The associated block type

Show child attributes

block_schema.block_type.id

string<uuid>

required

block_schema.block_type.created

string<date-time> | null

required

block_schema.block_type.updated

string<date-time> | null

required

block_schema.block_type.name

string

required

A block type's name

block_schema.block_type.slug

string

required

A block type's slug

block_schema.block_type.logo_url

string | null

Web URL for the block type's logo

block_schema.block_type.documentation_url

string | null

Web URL for the block type's documentation

block_schema.block_type.description

string | null

A short blurb about the corresponding block's intended use

block_schema.block_type.code_example

string | null

A code snippet demonstrating use of the corresponding block

block_schema.block_type.is_protected

boolean

default:false

Protected block types cannot be modified via API.

block_schema.capabilities

string[]

A list of Block capabilities

block_schema.version

string

default:non-versioned

Human readable identifier for the block schema

block_type_name

string | null

The associated block type's name

block_type

BlockType · object

The associated block type

Show child attributes

block_type.id

string<uuid>

required

block_type.created

string<date-time> | null

required

block_type.updated

string<date-time> | null

required

block_type.name

string

required

A block type's name

block_type.slug

string

required

A block type's slug

block_type.logo_url

string | null

Web URL for the block type's logo

block_type.documentation_url

string | null

Web URL for the block type's documentation

block_type.description

string | null

A short blurb about the corresponding block's intended use

block_type.code_example

string | null

A code snippet demonstrating use of the corresponding block

block_type.is_protected

boolean

default:false

Protected block types cannot be modified via API.

block_document_references

Block Document References · object

Record of the block document's references

Show child attributes

block_document_references.{key}

object

is_anonymous

boolean

default:false

Whether the block is anonymous (anonymous blocks are usually created by Prefect automatically)

API Reference

Headers

Body

Response