HTTP Request Skill

Make HTTP requests with enhanced output and JSON handling.

When to Use

✅ USE this skill when:

• "Make a GET request to..."
• "POST this JSON to..."
• "Call this API endpoint"
• "Download data from URL"
• "Test an API"

When NOT to Use

❌ DON'T use this skill when:

• Simple file downloads → use web-fetch/download.sh
• Browser automation → use browser-tools
• Web scraping → use web-fetch

Commands

GET Request

{baseDir}/request.sh GET "https://api.example.com/data"
{baseDir}/request.sh GET "https://api.example.com/data" --json
{baseDir}/request.sh GET "https://api.example.com/data" --header "Authorization: Bearer token"

POST Request

{baseDir}/request.sh POST "https://api.example.com/create" --data '{"name": "test"}'
{baseDir}/request.sh POST "https://api.example.com/create" --file data.json
{baseDir}/request.sh POST "https://api.example.com/upload" --form "file=@upload.txt"

PUT/PATCH/DELETE

{baseDir}/request.sh PUT "https://api.example.com/update/1" --data '{"name": "updated"}'
{baseDir}/request.sh PATCH "https://api.example.com/patch/1" --data '{"status": "active"}'
{baseDir}/request.sh DELETE "https://api.example.com/delete/1"

With Authentication

{baseDir}/request.sh GET "https://api.example.com/private" --auth bearer:TOKEN
{baseDir}/request.sh GET "https://api.example.com/private" --auth basic:user:pass
{baseDir}/request.sh GET "https://api.example.com/private" --header "X-API-Key: secret"

Custom Options

{baseDir}/request.sh GET "https://api.example.com" --timeout 60
{baseDir}/request.sh GET "https://api.example.com" --follow --max-redirects 5
{baseDir}/request.sh GET "https://api.example.com" --verbose

Options

• --data <json>: Request body (JSON string)
• --file <path>: Read request body from file
• --form <data>: Form data or file upload (@filename)
• --header <header>: Custom header (can be repeated)
• --auth <type:credentials>: Authentication (bearer:TOKEN or basic:user:pass)
• --timeout <sec>: Request timeout (default: 30)
• --json: Format JSON response
• --verbose: Show request details
• --follow: Follow redirects
• --max-redirects <n>: Max redirects (default: 5)
• --out <file>: Save response to file

Examples

Get JSON and format:

{baseDir}/request.sh GET "https://jsonplaceholder.typicode.com/users" --json

POST data:

{baseDir}/request.sh POST "https://api.example.com/users" \
  --data '{"name": "John", "email": "john@example.com"}' \
  --json

With Bearer token:

{baseDir}/request.sh GET "https://api.example.com/protected" \
  --auth bearer:your_token_here

Upload file:

{baseDir}/request.sh POST "https://api.example.com/upload" \
  --form "file=@document.pdf"

Notes

• Automatically adds Content-Type: application/json for JSON data
• Handles response body parsing
• Shows response headers with --verbose
• Supports multipart form data uploads