Skip to main content

http

Full HTTP client for interacting with REST APIs and web services. Supports all methods, JSON APIs, form submission, file upload, and background downloads.

PropertyValue
Module IDhttp
Version1.0.0
Typeuser
Dependencieshttpx or aiohttp

Design Philosophy

  • Method-specific actions — dedicated actions for GET, POST, PUT, PATCH, DELETE instead of a single generic request. Clearer semantics for the agent.
  • Auto-parsing — responses are automatically parsed based on content type (JSON, text, binary).
  • Background downloads — large files download in the background with progress tracking.
  • Security-aware — read-only methods (GET, HEAD, OPTIONS) are low risk. Write methods are medium risk.

Actions (16)

request

Generic HTTP request with full control. Parameters: method, url, headers, body, params. Risk: medium

get

HTTP GET with auto-parsed response. Parameters: url, headers, params. Risk: low

post

HTTP POST with JSON serialization. Parameters: url, data, headers. Risk: medium

put

HTTP PUT. Parameters: url, data, headers. Risk: medium

patch

HTTP PATCH. Parameters: url, data, headers. Risk: medium

delete

HTTP DELETE. Parameters: url, headers. Risk: medium

HTTP HEAD — headers only. Parameters: url. Risk: low

options

HTTP OPTIONS — CORS and allowed methods. Parameters: url. Risk: low

json_api

Call a JSON API endpoint with auto-headers. Parameters: url, method, data. Risk: medium

submit_form

Submit an HTML form (URL-encoded). Parameters: url, data. Risk: medium

upload_file

Upload a file via multipart POST. Parameters: url, file_path, field_name. Risk: medium

fetch_page

Fetch a web page and extract readable text. Parameters: url. Risk: low

download

Start a background file download. Parameters: url, path. Risk: medium

download_status

Check download progress. Parameters: download_id. Risk: low

download_cancel

Cancel a running download. Parameters: download_id. Risk: low

download_list

List all downloads with status. Risk: low