client.blocks.versions

client.blocks.versions — the blocks.versions operations.

On AsyncKindgi every method is the same, awaited.

client.blocks.versions.list()

list(
    block_id: str | UUID,
    /,
    *,
    limit: int | None = None,
    cursor: str | None = None,
    include_tombstoned: bool | None = None,
    timeout: float | None = None,
) -> BlockCollectionPage

List versions of a data block. GET /v1/blocks/{blockId}/versions

Newest published first. ?includeTombstoned=true includes unregistered versions, each with unregisteredAt.

client.blocks.versions.get()

get(block_id: str | UUID, version: str, /, *, timeout: float | None = None) -> Block

Fetch a specific data block version. GET /v1/blocks/{blockId}/versions/{version}

An unregistered version is returned too, with unregisteredAt.

client.blocks.versions.unregister()

unregister(
    block_id: str | UUID,
    version: str,
    /,
    *,
    idempotency_key: str | None = None,
    timeout: float | None = None,
) -> UnregisterBlockResult

Unregister a data block version. POST /v1/blocks/{blockId}/versions/{version}/unregister

Soft: no range picks it any more, but the agent versions that pin it keep running it, and GET still reads it. Needs write on the project.

client.blocks.versions.reinstate()

reinstate(
    block_id: str | UUID,
    version: str,
    /,
    *,
    idempotency_key: str | None = None,
    timeout: float | None = None,
) -> ReinstateBlockResult

Reinstate an unregistered data block version. POST /v1/blocks/{blockId}/versions/{version}/reinstate

Unchanged, as published. Idempotent. Needs write on the project.