Byteforms connects to a Nagent workspace with an API key. Once it is connected, agents can call 5 Byteforms actions, such as "Create form", "Get All Forms" and "Get Form By ID". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Byteforms, with input parameters and output schema.
BYTEFORMS_CREATE_FORMCreates a new form in ByteForms. Use this to build data collection forms with customizable fields (text, email, phone), styling options (theme, width), and submission rules (limits, deadlines, password protection). Returns the created form with its public_id for sharing.
Input parameters
List of form fields/components. Each field needs component type, input type, label, page, index, and unique id
Display name of the form (shown to users)
Options for form creation request.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BYTEFORMS_DELETE_FORMTool to delete a form by its ID. Use when you need to remove an existing form permanently.
Input parameters
The internal numeric ID of the form to delete. Get this from the 'id' field (not 'public_id') when listing or creating forms.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BYTEFORMS_GET_ALL_FORMS2Tool to fetch all forms created by the authenticated user. Use after authentication to list existing forms.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BYTEFORMS_GET_FORM_BY_IDRetrieves detailed information about a specific form by its numeric ID. Returns the form's name, fields, configuration options, and metadata. Use the numeric 'id' field (not the 'public_id' string) from form data obtained via BYTEFORMS_GET_ALL_FORMS or BYTEFORMS_CREATE_FORM.
Input parameters
The numeric ID of the form to retrieve (use the 'id' field from form data, not 'public_id')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BYTEFORMS_GET_FORM_RESPONSESTool to retrieve responses for a specific form with optional pagination and filtering. Use when the form has collected submissions and you need to navigate large result sets.
Input parameters
Cursor for pagination — returns items after this cursor
Maximum number of responses to return, must be ≥1
Sort order for responses by creation time
Filter responses containing this string
Cursor for pagination — returns items before this cursor
The numeric ID of the form to retrieve responses for (use the 'id' field from form data, not 'public_id')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 5 Byteforms actions on Nagent, including "Create form", "Get All Forms" and "Get Form By ID". Create form: Creates a new form in ByteForms. Each action is listed on this page with its input parameters and its output.
Byteforms connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Create form takes 2 required inputs: body and name. It also takes 1 optional input: options. It returns data, error and successful.