Items
Items
Reference for listing, creating, updating, trashing, restoring, and permanently deleting items.
Items endpoints let you manage item records through the Blueputto Public API. Use this section when you need paginated reads, lifecycle management, or direct item mutations.
Base Path
/v1/itemsItem request bodies and returned item objects are intentionally open-ended in the public OpenAPI schema. Expect the exact fields to match your Blueputto workspace model.
Endpoints
GET /v1/items
List items with pagination, search, and an optional trash-only filter.
POST /v1/items
Create a new item from a JSON request body.
GET /v1/items/{itemId}
Fetch a single item by UUID.
PATCH /v1/items/{itemId}
Partially update an existing item.
DELETE /v1/items/{itemId}
Move an item to the trash.
POST /v1/items/{itemId}/restore
Restore a trashed item.
DELETE /v1/items/{itemId}/permanent
Permanently delete an item.