api delete
HTTP DELETE with optional body or body file
Syntax
When I api delete "<path>"
When I api delete "<path>" with body '<json-or-text>'
When I api delete "<path>" with body file "<filename>"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 delete "/orders/ord-1"
Then I api should status "204"