Flowbyte - Soluciones tecnológicas para impulsar tu negocio

Query Items

Query items of a concept with optional filters, sorting and pagination. Returns a paginated list of items. IMPORTANT: call get_app first to discover the available conceptRoles for this app before querying.

Create Item

Create a new item for a given concept. ALWAYS call get_app first (or read the app://current resource) before creating any item. Use app.concepts to identify the correct conceptRole and the expected input fields. Example workflow: user says 'I spent 4€ on food' → call get_app → find concept with role 'gasto' → create item with conceptRole='gasto' and the matching data fields.

Get Item

Retrieve a single item by its ID.

Update Item

Partially update an existing item. Only provided fields are changed (deep merge on JSONB).

Get App

Retrieve the full app configuration for this tenant — including all concept definitions (roles, labels, input fields and their types). THIS MUST BE THE FIRST TOOL YOU CALL in any session. The returned app.concepts array tells you every available conceptRole and its schema. Use this knowledge to correctly classify user intent: e.g. 'I spent 4€ on food' maps to the concept whose role is 'gasto', and 'I sold a product' maps to 'venta', etc. Without calling get_app first you cannot know which roles

Update App

Partially update the app associated with this tenant. Looks up the app by tenantAttached and applies a partial merge on the provided fields.

List Concepts

List all concepts defined in the app (app.concepts). Returns the array of concept definitions, each with its role, label and inputs.

Get Concept

Retrieve a single concept definition by its role.

Add Concept

Add a new concept to the app (app.concepts). A concept defines a data type for the app (e.g. clients, drawings, appointments). The role must be unique within the app. This operation saves the full updated concepts array back to the app.

Update Concept

Update an existing concept in the app (app.concepts) by its role. Performs a shallow merge of the provided fields onto the existing concept. To update nested fields like inputs, provide the full replacement array.

Remove Concept

Remove a concept from the app (app.concepts) by its role. WARNING: this does not delete existing items of that concept — only the concept definition is removed from the app.

Delete Item

Soft-delete an item by ID. The item is marked as deleted but not removed from the database.