form_input
Set a single form field value by element reference. Fills one known input, textarea, select, or checkbox.
Instructions
Set one form element value by ref. Pass intent="..." (≤120 chars) to label this action in audit logs.
When to use: Filling a single known input, textarea, select, or checkbox by ref. When NOT to use: Use fill_form({fields:{...}}) for multiple fields or optional submit.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tabId | Yes | Tab ID to set form value in | |
| ref | Yes | Element ref or backendNodeId | |
| value | Yes | Value to set. Checkboxes: "true"/"false" | |
| intent | No | Human-readable label for this action in audit logs (≤120 chars) | |
| capture_artifact | No | When true, stage a replay artifact step for oc_skill_record. Default false is a strict no-op. | |
| returnAfterState | No | Optional chaining hint. When "ax" or "dom", the response includes a page snapshot of that mode captured after the post-action wait, removing the need for a follow-up read_page call. Default: "none". |