API

REST API reference documentation. 147 services with authentication, endpoints, and gotchas.

Setup

On first use, read setup.md for usage guidelines.

When to Use

User asks about integrating a third-party API. This skill provides: - Authentication documentation - Endpoint reference with curl examples - Rate limits and pagination patterns - Common mistakes to avoid

Architecture

apis/                    # API reference files by category
  ├── ai-ml.md           # OpenAI, Anthropic, Cohere, etc.
  ├── payments.md        # Stripe, PayPal, Square, etc.
  ├── communication.md   # Twilio, SendGrid, Slack, etc.
  └── ...

~/api/                   # User preferences (optional)
  └── preferences.md     # Preferred language for examples

Quick Reference

API Categories

How to Navigate API Files

Each category file contains multiple APIs. Use the index at the top of each file:

1. Read the index first — Each file starts with an index table showing API names and line numbers
2. Jump to specific API — Use the line number to read only that section (50-100 lines each)
3. Example: bash # Read index head -20 apis/ai-ml.md # Read specific API section sed -n '119,230p' apis/ai-ml.md

Core Rules

1. Find the right file first — Use the API Categories table to locate the service.

2. Read the index, then jump — Each file has an index. Read only the section you need.

3. Include Content-Type — POST/PUT/PATCH requests need Content-Type: application/json.

4. Handle rate limits — Check X-RateLimit-Remaining header. Implement backoff on 429.

5. Validate responses — Some APIs return 200 with error in body. Check response structure.

6. Use idempotency keys — For payments and critical operations.

Common Mistakes

• Missing Content-Type: application/json on POST requests
• API keys in URL query params (use headers instead)
• Ignoring pagination (most APIs default to 10-25 items)
• No retry logic for 429/5xx errors
• Assuming HTTP 200 means success

Scope

This skill is documentation only. It provides: - API endpoint reference - Authentication patterns - Code examples for reference

The user manages their own API keys and runs commands themselves.

External Endpoints

This skill documents external APIs. Example endpoints shown are for the respective service providers (Stripe, OpenAI, etc.).

Related Skills

Install with clawhub install <slug> if user confirms:

• http — HTTP request patterns
• webhook — Webhook handling
• json — JSON processing

Feedback

• If useful: clawhub star api
• Stay updated: clawhub sync