KosmoKrator

productivity

Gravity Forms Lua API for KosmoKrator Agents

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

7 functions 6 read 1 write API key auth
Submit Gravity Forms feedback View package source

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.

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.gravity_list_forms({
  limit = 1,
  offset = 1
})
print(result)

Functions

gravity_list_forms

List forms available in Gravity with optional pagination.

Operation
Read read
Full name
gravity.gravity_list_forms
ParameterTypeRequiredDescription
limit integer no Maximum number of forms to return.
offset integer no Pagination offset.

gravity_get_form

Get details for a specific Gravity form.

Operation
Read read
Full name
gravity.gravity_get_form
ParameterTypeRequiredDescription
form_id string yes The form ID.

gravity_submit_form

Submit a Gravity form with field values.

Operation
Write write
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.

gravity_list_submissions

List submissions for a specific Gravity form.

Operation
Read read
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.

gravity_list_entries

List entries for a specific Gravity form.

Operation
Read read
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.

gravity_get_entry

Get details for a specific Gravity entry.

Operation
Read read
Full name
gravity.gravity_get_entry
ParameterTypeRequiredDescription
entry_id string yes The entry ID.

gravity_get_current_user

Get profile information for the authenticated Gravity user.

Operation
Read read
Full name
gravity.gravity_get_current_user
ParameterTypeRequiredDescription
No parameters.