control.http.request

Make a generic HTTP/REST request so integrations without a first-class workflow are reachable

Overview

Property	Value
Workflow type	Atomic
Library	App-control
Version	1.0

Input Schema

Field	Type	Required	Default	Description
method	string	Yes	—	HTTP method: GET/POST/PUT/PATCH/DELETE
url	string	Yes	—	Target URL (non-empty)
headers	json	No	—	Request headers (object or JSON-encoded string)
body	string	No	—	Request body, sent as-is (caller encodes it)
timeout_seconds	integer	No	—	Request timeout in seconds (default 30; capped at 300)
fail_on_http_error	boolean	No	—	Fail on 4xx/5xx responses by default; false returns them as outputs

Output Schema

Field	Type	Required	Default	Description
method	string	No	—	—
url	string	No	—	—
headers	json	No	—	—
body	string	No	—	—
timeout_seconds	integer	No	—	—
fail_on_http_error	boolean	No	—	—
response_status_code	integer	No	—	HTTP status. Populated on 2xx, or on any status when fail_on_http_error=false
response_body	string	No	—	Response body. Populated on 2xx, or on any status when fail_on_http_error=false
response_headers	json	No	—	Allowlisted response headers. Populated on 2xx, or on any status when fail_on_http_error=false
failure_reason	string	No	—	—
failure_type	string	No	—	—
failed_action	string	No	—	—
failed_at_state	string	No	—	—
failed_step	string	No	—	—
failed_layer	string	No	—	—
error	string	No	—	—
error_type	string	No	—	—

States

State	Initial	Terminal	Success	Auto-advance	Description
pending	Yes	No	—	execute	—
completed	No	Yes	Yes	—	—
failed	No	Yes	No	—	—

State Diagram

Transitions

From	Action	To	Description
pending	execute	completed	—
* (any state)	fail	failed	—

API Usage

POST /api/workflows/start
Content-Type: application/json

{
  "workflow_type": "control.http.request",
  "initial_data": {
    "method": "value",
    "url": "value"
  }
}