# Overview

## Blocks

Data blocks: versioned prompts and settings an agent version pins when it’s published (list, get, versions, publish, unregister, reinstate). A version never changes, nor does a block’s kind; a settings block’s values satisfy its schema and the latest version’s. A block belongs to one project and is authorized through it: `read` on the project to read, `write` to publish, unregister or reinstate. Caller-plugged via `BlockRegistryBinding`.

## Operations

GET

[/v1/blocks](https://docs.kindgi.com/v0.1.8/reference/api/operations/blockslist.md)

POST

[/v1/blocks](https://docs.kindgi.com/v0.1.8/reference/api/operations/blockspublish.md)

GET

[/v1/blocks/{blockId}](https://docs.kindgi.com/v0.1.8/reference/api/operations/blocksget.md)

GET

[/v1/blocks/{blockId}/versions](https://docs.kindgi.com/v0.1.8/reference/api/operations/blocksversionslist.md)

GET

[/v1/blocks/{blockId}/versions/{version}](https://docs.kindgi.com/v0.1.8/reference/api/operations/blocksversionsget.md)

POST

[/v1/blocks/{blockId}/versions/{version}/unregister](https://docs.kindgi.com/v0.1.8/reference/api/operations/blocksversionsunregister.md)

POST

[/v1/blocks/{blockId}/versions/{version}/reinstate](https://docs.kindgi.com/v0.1.8/reference/api/operations/blocksversionsreinstate.md)