KosmoKrator

productivity

Gravity Forms Lua API for KosmoKrator Agents

Agent-facing Lua documentation and function reference for the Gravity Forms KosmoKrator integration.

Lua Namespace

Agents call this integration through app.integrations.gravity.*. Use lua_read_doc("integrations.gravity") inside KosmoKrator to discover the same reference at runtime.

Call Lua from the Headless CLI

Use kosmo integrations:lua when a shell script, CI job, cron job, or another coding CLI should run a deterministic Gravity Forms workflow without starting an interactive agent session.

Inline Lua call 
kosmo integrations:lua --eval 'dump(app.integrations.gravity.list_forms({limit = 1, offset = 1}))' --json
Read Lua docs headlessly 
kosmo integrations:lua --eval 'print(docs.read("gravity"))' --json
kosmo integrations:lua --eval 'print(docs.read("gravity.list_forms"))' --json

Workflow file

Put repeatable logic in a Lua file, then execute it with JSON output for the calling process.

workflow.lua 
local gravity = app.integrations.gravity
local result = gravity.list_forms({limit = 1, offset = 1})

dump(result)
Run the workflow 
kosmo integrations:lua workflow.lua --json
kosmo integrations:lua workflow.lua --force --json
Namespace note. integrations:lua exposes app.integrations.gravity, app.mcp.*, docs.*, json.*, and regex.*. Use app.integrations.gravity.default.* or app.integrations.gravity.work.* when you configured named credential accounts.

MCP-only Lua

If the script only needs configured MCP servers and does not need Gravity Forms, use the narrower mcp:lua command.

MCP Lua command 
# Use mcp:lua for MCP-only scripts; use integrations:lua for this integration namespace.
kosmo mcp:lua --eval 'dump(mcp.servers())' --json

Agent-Facing Lua Docs

This is the rendered version of the full Lua documentation exposed to agents when they inspect the integration namespace.

Gravity Forms — Lua API Reference

Use app.integrations.gravity to list forms, inspect form definitions, submit data, and read submissions or entries.

gravity_list_forms

List forms with optional pagination.

local result = app.integrations.gravity.gravity_list_forms({
  limit = 25,
  offset = 0
})

gravity_get_form

Get details for a form.

local result = app.integrations.gravity.gravity_get_form({
  form_id = "contact"
})

gravity_submit_form

Submit form field values.

local result = app.integrations.gravity.gravity_submit_form({
  form_id = "contact",
  data = {
    name = "Example User",
    message = "Hello from an agent"
  }
})

gravity_list_submissions

List submissions for a form.

local result = app.integrations.gravity.gravity_list_submissions({
  form_id = "contact",
  limit = 25
})

gravity_list_entries

List entries for a form.

local result = app.integrations.gravity.gravity_list_entries({
  form_id = "contact",
  limit = 25
})

gravity_get_entry

Get one entry by ID.

local result = app.integrations.gravity.gravity_get_entry({
  entry_id = "entry_123"
})

gravity_get_current_user

Get profile information for the authenticated Gravity user.

local result = app.integrations.gravity.gravity_get_current_user({})
Raw agent markdown 
# Gravity Forms — Lua API Reference

Use `app.integrations.gravity` to list forms, inspect form definitions, submit data, and read submissions or entries.

## gravity_list_forms

List forms with optional pagination.

```lua
local result = app.integrations.gravity.gravity_list_forms({
  limit = 25,
  offset = 0
})
```

## gravity_get_form

Get details for a form.

```lua
local result = app.integrations.gravity.gravity_get_form({
  form_id = "contact"
})
```

## gravity_submit_form

Submit form field values.

```lua
local result = app.integrations.gravity.gravity_submit_form({
  form_id = "contact",
  data = {
    name = "Example User",
    message = "Hello from an agent"
  }
})
```

## gravity_list_submissions

List submissions for a form.

```lua
local result = app.integrations.gravity.gravity_list_submissions({
  form_id = "contact",
  limit = 25
})
```

## gravity_list_entries

List entries for a form.

```lua
local result = app.integrations.gravity.gravity_list_entries({
  form_id = "contact",
  limit = 25
})
```

## gravity_get_entry

Get one entry by ID.

```lua
local result = app.integrations.gravity.gravity_get_entry({
  entry_id = "entry_123"
})
```

## gravity_get_current_user

Get profile information for the authenticated Gravity user.

```lua
local result = app.integrations.gravity.gravity_get_current_user({})
```
Metadata-derived Lua example 
local result = app.integrations.gravity.list_forms({limit = 1, offset = 1})
print(result)

Functions

list_forms Read

List forms available in Gravity with optional pagination.

Lua path
app.integrations.gravity.list_forms
Full name
gravity.gravity_list_forms
ParameterTypeRequiredDescription
limit integer no Maximum number of forms to return.
offset integer no Pagination offset.
get_form Read

Get details for a specific Gravity form.

Lua path
app.integrations.gravity.get_form
Full name
gravity.gravity_get_form
ParameterTypeRequiredDescription
form_id string yes The form ID.
submit_form Write

Submit a Gravity form with field values.

Lua path
app.integrations.gravity.submit_form
Full name
gravity.gravity_submit_form
ParameterTypeRequiredDescription
form_id string yes The form ID.
data object yes Form field values keyed by field name or ID.
list_submissions Read

List submissions for a specific Gravity form.

Lua path
app.integrations.gravity.list_submissions
Full name
gravity.gravity_list_submissions
ParameterTypeRequiredDescription
form_id string yes The form ID.
limit integer no Maximum number of submissions to return.
offset integer no Pagination offset.
list_entries Read

List entries for a specific Gravity form.

Lua path
app.integrations.gravity.list_entries
Full name
gravity.gravity_list_entries
ParameterTypeRequiredDescription
form_id string yes The form ID.
limit integer no Maximum number of entries to return.
offset integer no Pagination offset.
get_entry Read

Get details for a specific Gravity entry.

Lua path
app.integrations.gravity.get_entry
Full name
gravity.gravity_get_entry
ParameterTypeRequiredDescription
entry_id string yes The entry ID.
get_current_user Read

Get profile information for the authenticated Gravity user.

Lua path
app.integrations.gravity.get_current_user
Full name
gravity.gravity_get_current_user
ParameterTypeRequiredDescription
No parameters.