Update docs

Author: fredsted

docs/api/databases.md

@@ -8,31 +8,58 @@
 
 **POST** <code>https://webhook.site/database/<span class="url-param">databaseId</span>/query</code>
 
-* `query`: The SQL query to execute.
+* `query`: (string, required) The SQL query to execute.
+* `params`: (array|object) A list or dictionary of parameters. Can be left out if query has no parameters.
+
+A maximum of 1000 results can be returned.
+
+```json
+{
+  "query": "select * from users where email like concat('%', :domain)",
+  "params": {
+    "domain": "@example.com"
+  }
+}
+```
+
+It is also possible to use a list of parameters:
 
 ```json
 {
-  "query": "select * from mytable;"
+  "query": "select * from users where email like concat('%', ?)",
+  "params": [
+    "@example.com"
+  ]
+}
+```
+
+`params` can be left out if not needed:
+
+```json
+{
+  "query": "select * from users where email = '[email protected]'"
 }
 ```
 
 #### Response
 
 * `result`: (array) The returned data.
-* `error`: (string) If the query results in an error, the error is represented here.
+* `error`: (string) If the query results in an error, the error is represented here, otherwise `null`.
 * `time`: (float) Query execution time in milliseconds.
 
 ```json
 {
   "result": [
     {
       "id": 1,
-      "value": "hello world"
+      "name": "Jack Daniels",
+      "email": "[email protected]"
     },
     {
       "id": 2,
-      "value": "it's a great day to be a query"
-    }
+      "name": "Elijah Craig",
+      "email": "[email protected]"
+    },
   ],
   "error": null,
   "time": 0

docs/database.md

@@ -7,6 +7,10 @@ nav_order: 390
 
 Store and process data in the Webhook.site Cloud using Databases. Built right in to Webhook.site, Databases provide a fully-featured PostgreSQL-compatible database. You can create and remove tables, create columns and run queries in the Console. 
 
+<div class="center">
+<a href="https://webhook.site/control-panel/databases" class="md-button md-button--default no-underline">Create Database</a>
+</div>
+
 With Webhook.site Custom Actions, you can interact with your Database to store, update, retrieve and remove data by SQL Query whenever a Webhook.site URL or E-mail Address receives a hit.
 
 Additionally, with Webhook.site's simple API, you can manage your Database, including running SQL queries.

docs/news.markdown

@@ -24,6 +24,12 @@ Subscribe below to receive updates about improvements and new features on Webhoo
 </form>
 </div>
 
+## 8 October 2025
+
+* Added support for [Webhook.site Databases](/databases.html) in WebhookScript. [More info here](/webhookscript/functions/database.html).
+* Added `params` to the [Database Query API](/api/databases.html#run-query).
+* Increased maximum row count in Database actions to 1000.
+
 ## 1 October 2025
 
 * New Feature: **Webhook.site Databases**, our new built-in database service hosted on the Webhook.site Cloud, is released to all users, and as an introductory offer, all Webhook.site Subscribers can create 1 DB-S instance for free. [More info here](/databases.html). <br> Create your Database now in Control Panel &rarr; [Databases](https://webhook.site/control-panel/databases).

docs/webhookscript/functions/database.md

@@ -0,0 +1,59 @@
+## Database
+
+### db(***string/int*** db_id) : function
+
+The `db_id` parameter must either be the name or ID of a [Webhook.site Database](/database.html) instance.
+
+When called directly, `db()` returns a Webhook.site Database instance in the form of a function that takes the following arguments: `query`, `params` and returns an array with the following keys: `result`, `error`, `time`.
+
+```javascript
+// Connect to a Webhook.site Database instance
+mydb = db('mydb')
+
+// You can use both numeric parameter names ...
+res = mydb(
+  'insert into users (name, email) values (?, ?)',
+  [
+    get('request.query.name'),
+    get('request.query.email')
+  ]
+)
+dump(res)
+// [
+//   "result": [
+//     0: []
+//   ], 
+//   "error": null, 
+//   "time": 0
+// ]
+
+
+// ... as well as named
+res = mydb(
+  'select * from users where email = :email',
+  [
+    'email': get('request.query.email')
+  ]
+)
+dump(res)
+// [
+//   "result": [
+//     0: [
+//       "name": "example", 
+//       "email": "[email protected]"
+//       ]
+//     ], 
+//   "error": null, 
+//   "time": 0
+// ]
+
+
+// On error, the `error` key is set:
+res = db('select * from nonexisting_table')
+dump(res)
+// [
+//   "result": null, 
+//   "error": "Undefined table: 7 ERROR: relation \"nonexisting\" does not exist", 
+//   "time": 0
+// ]
+```

mkdocs.yml

@@ -84,6 +84,7 @@ nav:
         - Flow Control and Responses: webhookscript/functions/flow.md
         - Math and Numbers: webhookscript/functions/math.md
         - Network and HTTP: webhookscript/functions/network.md
+        - Databases: webhookscript/functions/database.html
         - Strings: webhookscript/functions/string.md
         - Custom Action Variables: webhookscript/functions/variables.md
     - Examples: custom-actions/examples.markdown