HTTP Client Examples

Example httpClient: resources for common API integration patterns. See HTTP Client Resource for the full configuration reference.

Fetch Data and Process

# resources/fetch-data.yaml
actionId: fetchData
httpClient:
  method: GET
  url: "https://api.github.com/repos/{{ get('owner') }}/{{ get('repo') }}"
  headers:
    Accept: application/vnd.github.v3+json
    Authorization: "Bearer {{ get('GITHUB_TOKEN', 'env') }}"
  timeout: 30s

---

actionId: analyzeRepo
requires: [fetchData]
chat:
  model: llama3.2:1b
  prompt: "Analyze this GitHub repo: {{ get('fetchData') }}"

Authenticated API with Retry

# resources/example.yaml
httpClient:
  method: POST
  url: "https://api.stripe.com/v1/charges"
  auth:
    type: bearer
    token: "{{ get('STRIPE_SECRET_KEY', 'env') }}"
  headers:
    Content-Type: application/x-www-form-urlencoded
  data:
    amount: "{{ get('amount') }}"
    currency: usd
    source: "{{ get('token') }}"
  retry:
    maxAttempts: 3
    backoff: 2s
    retryOn: [500, 502, 503]
  timeout: 30s

Webhook Call

# resources/example.yaml
httpClient:
  method: POST
  url: "{{ get('webhook_url') }}"
  headers:
    Content-Type: application/json
    X-Webhook-Secret: "{{ get('WEBHOOK_SECRET', 'env') }}"
  data:
    event: order_completed
    order_id: "{{ get('order_id') }}"
    timestamp: "{{ info('timestamp') }}"
  timeout: 10s

Cached External API

# resources/example.yaml
httpClient:
  method: GET
  url: "https://api.exchangerate.host/latest"
  cache:
    ttl: 1h
    key: "exchange-rates"
  timeout: 30s

See Also

• HTTP Client Resource - Full configuration reference
• Tools Reference - Use HTTP client as an LLM tool
• SQL Examples - Database query patterns