api set field
Queue one multipart text field on the Platform api session
Queue a single multipart form text field. Send with a bare api post / put / patch after any fields and files are set.
Syntax
When I api set field "<name>" to "<value>"Qualifiers
| Qualifier | Role | Example |
|---|---|---|
to | Field value | api set field "name" to "Invoice" |
Requirements
| Item | Contract |
|---|---|
| Element / control shape | None — HTTP session (Platform: api) |
| How the label binds | Path / body / headers are payloads ($ENV, slots expand) |
| Qualifiers that change resolve | See this command’s Qualifiers table |
| Platform | Platform: api only — requires $API_BASE_URL (and auth env as needed) |
| Wrong shape → use instead | UI XHR wait → wait for response. Browser UI → web commands |
See also UI contracts and Platform: api.
Examples
When I api set field "name" to "Invoice"
When I api set field "note" to "rush"
When I api set file "main" to "invoice.pdf"
When I api post "/upload"Notes
- Values expand via shared resolve (
$ENV,@/@@slots,{{faker}}). - Same field name overwrites the previous value.
- Do not combine a pending form queue with
with body/with body fileon the send step. api get/api deletefail if a form queue is still pending.