Totalum

Whoami

Returns the authenticated user and tenant from this session

Get All Database Tables

Get all database table definitions including all table fields definitions from the project

Create Database Table

Create a new database table in the project. IMPORTANT INFORMATION: If the relationship is manyToMany, NOT CREATE THE JUNCTION TABLE, totalum automatically create and manages the junction table. SUPER IMPORTANT: Always remember to add links between tables creating properties of type objectReference after tables are created.

Delete Database Table By Id

Delete an entire database table and all its records from the project. WARNING: This is destructive and will delete all table data!

Create Table Property

Create a new property in an existing database table (can be a normal property or a relation)

Edit Table Property

Edit an existing property in a table data structure

Delete Table Property

Delete a property from a database table

Create Record

Create a new record in a specific database table

Query

Powerful query endpoint for fetching records with nested relations, filtering, sorting, pagination, parent filtering by children (_has), child counts (_count), aggregation (_aggregate), grouping (_groupBy), and response shaping (_omit). Use this for advanced queries that need to fetch related data across tables in a single call.

Get Record By Id

Get a specific record by its ID from a database table table

Add Many To Many Reference

Add a many-to-many relationship reference between two records

Drop Many To Many Reference

Remove a many-to-many relationship reference between two records

Edit Record Properties

Edit/update properties of an existing record in a database table

Delete Record By Id

Delete a record from a data structure/table

Get Record History

Get the historic updates/changes of a record by its ID. Returns a list of changes made to the record over time, including timestamps, authors, and old/new values.

Check If Image Exists By Url

Check if an image exists at the specified URL

Upload File From Url

Upload a file to Totalum by providing a URL. The file is uploaded to Totalum. IMPORTANT: The file size must be less than 15MB. Returns a file name/ID that can be used to attach to Totalum records of type 'file' or 'multiple file' properties.

Get Production Logs

Get production logs from your published Startum project. Only use this if user say that some feature not works with the project published. Because the other logs of your local project are on the soruce code. Only available if the project has been deployed to production. Logs are retained for 3 days maximum. The best approach is to filter by regexSearch (will return the regex match and all the near logs)

Generate Image

Generate an image from scratch using OpenAI gpt-image-1. Returns a filename that can be used to attach to Totalum records with 'file' type properties or to get a download URL. IMPORTANT: Only use this tool if the user asks you to generate an image with AI. Always prefer the smallest size and fastest quality to keep it fast and cheap, unless the user requests higher quality or larger size.

Edit Image

Edit or transform existing image(s) using OpenAI gpt-image-1. Supports: editing parts of an image (e.g. change clothes keeping face), using images as style reference, combining multiple images, and masked editing. Returns a filename of the resulting image. IMPORTANT: Only use this tool if the user asks you to edit an image with AI. Always prefer the smallest size and fastest quality to keep it fast and cheap, unless the user requests higher quality or larger size.