Submissions

A submission is the data a human enters into a form. Submissions are immutable, versioned to the form definition at the time of submission, and retained according to the form’s settings.retentionDays.

Tail submissions (live)

Watch for new submissions in real time:

agentsforms submissions tail support-intake

Output:

[2026-06-23 10:30:22] sub_def456  email=user@example.com  priority=high
[2026-06-23 10:31:05] sub_def457  email=other@example.com priority=low

List submissions

agentsforms submissions list support-intake --limit 20

For machine-readable output:

agentsforms submissions list support-intake --json

Get a submission

agentsforms submissions get sub_def456

Or via API:

curl -X GET https://api.agentsforms.com/v1/submissions/sub_def456 \
  -H "Authorization: Bearer $AGENT...EY"

Response:

{
  "submission": {
    "id": "sub_def456",
    "form_id": "form_abc123",
    "form_version": 1,
    "session_id": "sess_xyz789",
    "answers": {
      "email": "user@example.com",
      "priority": "high",
      "message": "My billing page is broken"
    },
    "partial": false,
    "submitted_at": "2026-06-23T10:30:22Z"
  }
}

Answers

The answers object maps field ids to their submitted values:

Field type	Answer value shape
`text`, `textarea`, `email`, `url`	`string`
`number`	`number`
`boolean`, `checkbox`	`boolean`
`date`	`string` (ISO 8601)
`select`, `radio`	`string` (the selected `value`)
`multi_select`	`string[]` (array of selected values)
`hidden`	`unknown` (whatever was prefilled)
`file`	`{ filename: string, url: string, size: number }`

Retention

Submissions are retained for the number of days specified in settings.retentionDays. After that, they are permanently deleted. If retentionDays is not set, submissions are retained indefinitely.