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#

text

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#

FilePurposesetup.mdUsage guidelinescredentials.mdMulti-account credential naming ( {SERVICE}_{ACCOUNT}_{TYPE})auth.mdAuthentication patternspagination.mdPagination patternsresilience.mdError handling patternswebhooks.mdWebhook patterns

API Categories#

CategoryFileServicesAI/MLapis/ai-ml.mdanthropic, openai, cohere, groq, mistral, perplexity, huggingface, replicate, stability, elevenlabs, deepgram, assemblyai, together, anyscalePaymentsapis/payments.mdstripe, paypal, square, plaid, chargebee, paddle, lemonsqueezy, recurly, wise, coinbase, binance, alpaca, polygonCommunicationapis/communication.mdtwilio, sendgrid, mailgun, postmark, resend, mailchimp, slack, discord, telegram, zoomRealtimeapis/realtime.mdsendbird, stream-chat, pusher, ably, onesignal, courier, knock, novuCRMapis/crm.mdsalesforce, hubspot, pipedrive, attio, close, apollo, outreach, gongMarketingapis/marketing.mddrift, crisp, front, customer-io, braze, iterable, klaviyoDeveloperapis/developer.mdgithub, gitlab, bitbucket, vercel, netlify, railway, render, fly, digitalocean, heroku, cloudflare, circleci, pagerduty, launchdarkly, split, statsigDatabaseapis/database.mdsupabase, firebase, planetscale, neon, upstash, mongodb, fauna, xata, convex, appwriteAuthapis/auth-providers.mdclerk, auth0, workos, stytchMediaapis/media.mdcloudinary, mux, bunny, imgix, uploadthing, uploadcare, transloadit, vimeo, youtube, spotify, unsplash, pexels, giphy, tenorSocialapis/social.mdtwitter, linkedin, instagram, tiktok, pinterest, reddit, twitchProductivityapis/productivity.mdnotion, airtable, google-sheets, google-drive, google-calendar, dropbox, linear, jira, asana, trello, monday, clickup, figma, calendly, cal, loom, typeformBusinessapis/business.mdshopify, docusign, hellosign, bitly, dubGeoapis/geo.mdopenweather, mapbox, google-mapsSupportapis/support.mdintercom, zendesk, freshdesk, helpscoutAnalyticsapis/analytics.mdmixpanel, amplitude, posthog, segment, sentry, datadog, algolia

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