Valstorm Developer Platform

Welcome to the Valstorm Developer Platform documentation. Valstorm is a powerful, metadata-driven platform for building complex business applications with ease.

Core Pillars

App Builder Engine: A sophisticated UI construction system.
Inputs System: Standardized data entry and display fields.
Developer CLI: Synchronize your local code and metadata with the Valstorm cloud.
Model Context Protocol (MCP): Seamlessly integrate AI models with your Valstorm data.
Comprehensive APIs: Robust REST endpoints and a typed Python SDK.
Automation System: The automation system consists of Record triggers, Functions and the no code Automation builder. These allow you to mix and match custom logic into your system
Record Triggers: These execute custom logic written in python when ever you create, update or delete records of a specific object.
Functions: These are custom python code that you can write as classes or functions within your record triggers, the drag and drop automation builder, in scheduled processes, or via the API.
Automation: The automation object allows you to create drag and drop automations in a flow builder. They can be used as a record trigger, called via the API, or invoked in functions and other record triggers.
Scheduled Trigger Settings: These allow you to run functions or automations on a cron schedule. They generate scheduled items that will be picked up by the scheduling system to run at the given run time.

Core APIs

Create, Update and Delete Records at https://api.valstorm.com/docs#tag/records
- All of these routes are bulkified
- To create, POST a list or a dictionary to https://api.valstorm.com/v1/object/{collection_name}. Replace the collection_name with the api_name of the object you want to create. You will receive a 200 response with the list of created records
- To update, PATCH a list or a dictionary to https://api.valstorm.com/v1/object/{collection_name}. Replace the collection_name with the api_name of the object you want to update. You must include the id field for all records you'd like to update. You will receive a 200 response with the list of updated records
- To delete, send a DELETE request to https://api.valstorm.com/v1/object/{collection_name}?ids=. You must include the ids as a comma separated list like ids=1,2,3. Replace the collection_name with the api_name of the object you want to delete. You will receive a 204 response
Query records via https://api.valstorm.com/docs#tag/query
- You can GET or POST to the query endpoints. POST allows for longer queries in case you need many ids.
- SQL like queries can be sent to https://api.valstorm.com/v1/query with a {"query": "SELECT fields FROM object WHERE clause ORDER BY DESC LIMIT 25"}
- You can execute graphql queries at this endpoint https://api.valstorm.com/v1/graphql
CRUD your database schemas via the schema routes
- https://api.valstorm.com/docs#tag/schema
CRUD files via the file routes. The file object and records in Valstorm are purely metadata about your stored files. You must use these routes to actually access the underlying file.
- https://api.valstorm.com/docs#tag/files

Explore the Docs

Core Pillars

App Builder Engine: A sophisticated UI construction system.

Inputs System: Standardized data entry and display fields.

Developer CLI: Synchronize your local code and metadata with the Valstorm cloud.

Model Context Protocol (MCP): Seamlessly integrate AI models with your Valstorm data.

Comprehensive APIs: Robust REST endpoints and a typed Python SDK.

Automation System: The automation system consists of Record triggers, Functions and the no code Automation builder. These allow you to mix and match custom logic into your system

Record Triggers: These execute custom logic written in python when ever you create, update or delete records of a specific object.

Functions: These are custom python code that you can write as classes or functions within your record triggers, the drag and drop automation builder, in scheduled processes, or via the API.

Automation: The automation object allows you to create drag and drop automations in a flow builder. They can be used as a record trigger, called via the API, or invoked in functions and other record triggers.

Scheduled Trigger Settings: These allow you to run functions or automations on a cron schedule. They generate scheduled items that will be picked up by the scheduling system to run at the given run time.

Core APIs

Create, Update and Delete Records at https://api.valstorm.com/docs#tag/records

All of these routes are bulkified
To create, POST a list or a dictionary to https://api.valstorm.com/v1/object/{collection_name}. Replace the collection_name with the api_name of the object you want to create. You will receive a 200 response with the list of created records
To update, PATCH a list or a dictionary to https://api.valstorm.com/v1/object/{collection_name}. Replace the collection_name with the api_name of the object you want to update. You must include the id field for all records you'd like to update. You will receive a 200 response with the list of updated records
To delete, send a DELETE request to https://api.valstorm.com/v1/object/{collection_name}?ids=. You must include the ids as a comma separated list like ids=1,2,3. Replace the collection_name with the api_name of the object you want to delete. You will receive a 204 response

Query records via https://api.valstorm.com/docs#tag/query

You can GET or POST to the query endpoints. POST allows for longer queries in case you need many ids.
SQL like queries can be sent to https://api.valstorm.com/v1/query with a {"query": "SELECT fields FROM object WHERE clause ORDER BY DESC LIMIT 25"}
You can execute graphql queries at this endpoint https://api.valstorm.com/v1/graphql

CRUD your database schemas via the schema routes

https://api.valstorm.com/docs#tag/schema

CRUD files via the file routes. The file object and records in Valstorm are purely metadata about your stored files. You must use these routes to actually access the underlying file.

https://api.valstorm.com/docs#tag/files