avodado
avodado docs
Blocks reference

API

Field contracts and worked examples for the 3 api blocks.

Field contracts and worked examples for the api blocks — converted at build time from the repo's authoring-skill reference. Every example body is YAML; in a real doc the fence language is the block type (for example sequence … ). Schemas are strict — unknown fields are rejected. See the field contract for the at-a-glance shape of all 77 blocks, or the block catalog for live previews.

API reference

endpoint — a Swagger-style API endpoint card

```endpointeditable · live
renderedavo renders this
SECTION 01 · API endpoint

Create an order

POST/orders/{cartId}Bearer <token>

Convert a cart into an order.

Parameters
NameInTypeDescription
cartId requiredpathuuidCart to convert
dry-runquerybooleanValidate without persisting
Request body
FieldTypeDescription
items requiredItem[]Line items
Responses
StatusDescription
201Order created
400Invalid cart
Example request
{ "items": [{ "sku": "A1", "qty": 2 }] }
Example response
{ "id": "ord_123", "status": "pending" }
Valid — passes avo check

Only method and path are required. params[].in is path | query | header | cookie. For a whole spec, generate docs with avo sync openapi.

pullquote — a standout quote

```pullquoteeditable · live
renderedavo renders this
SECTION 01 · Quote

Site group = read at that plant. Role group = extra actions on top.

The taxonomy in one line
Valid — passes avo check

layers — a layered explanation (N numbered layers)

```layerseditable · live
renderedavo renders this
SECTION 01 · Layers

Access in three layers

1
L1
Identity
IdP JWT
Signed in?
Validate the token.
2
L2
Site scope
lookup
Which sites?
Confirm site is in range.
3
L3
Permission
App DB
May you do this?
Resolve from the matrix.
Valid — passes avo check

Use layers (not a table) when content reads as ordered tiers each answering one question — e.g. an L1/L2/L3 model. callout also now supports tone: success (green).