Zyla Api Hub Skill

Weather by Zip API (ID: 781)

• Use when: user asks about weather, temperature, forecast, climate, conditions by zip code
• Category: Weather & Environment
• Call: npx tsx {baseDir}/scripts/zyla-api.ts call --api 781 --endpoint <endpoint_id> --params '{"zip":"10001"}'

Currency Conversion API (example)

• Use when: user asks about currency exchange, conversion rates, forex
• Category: Finance
• Call: npx tsx {baseDir}/scripts/zyla-api.ts call --api <id> --endpoint <endpoint_id> --params '{"from":"USD","to":"EUR","amount":"100"}'

Email Validation API (example)

• Use when: user asks to validate, verify, or check an email address
• Category: Data Validation
• Call: npx tsx {baseDir}/scripts/zyla-api.ts call --api <id> --endpoint <endpoint_id> --params '{"email":"[email protected]"}'

Note: Run npx tsx {baseDir}/scripts/generate-popular.ts to regenerate this section with real API IDs and endpoints from the live catalog.

Discovering APIs

For APIs not listed above, search the catalog:

# Search by keyword
npx tsx {baseDir}/scripts/zyla-catalog.ts search "recipe"

# List APIs by category
npx tsx {baseDir}/scripts/zyla-catalog.ts list --category "Finance"

# Get endpoints for a specific API
npx tsx {baseDir}/scripts/zyla-catalog.ts endpoints --api 781

Calling APIs

Using the helper script (recommended)

# Basic call
npx tsx {baseDir}/scripts/zyla-api.ts call \
  --api <api_id> \
  --endpoint <endpoint_id> \
  --params '{"key":"value"}'

# Specify HTTP method (default: GET)
npx tsx {baseDir}/scripts/zyla-api.ts call \
  --api <api_id> \
  --endpoint <endpoint_id> \
  --method POST \
  --params '{"key":"value"}'

# Get info about an API
npx tsx {baseDir}/scripts/zyla-api.ts info --api <api_id>

# Check health and remaining quota
npx tsx {baseDir}/scripts/zyla-api.ts health

Using curl (fallback)

curl -H "Authorization: Bearer $ZYLA_API_KEY" \
  "https://zylalabs.com/api/{api_id}/{api_slug}/{endpoint_id}/{endpoint_slug}?param=value"

URL pattern: https://zylalabs.com/api/{api_id}/{api_name_slug}/{endpoint_id}/{endpoint_name_slug}

• api_id and endpoint_id are numeric IDs (these do the actual routing)
• api_name_slug and endpoint_name_slug are URL-friendly names (for readability)

Error Handling

• 401 Unauthorized: API key is invalid or expired. Ask the user to run /zyla connect or visit https://zylalabs.com/openclaw/connect to get a new key.
• 403 Forbidden: Subscription issue. The pay-as-you-go plan should handle this automatically. If it persists, ask the user to contact support.
• 429 Too Many Requests: Rate limit exceeded. Check the X-Zyla-RateLimit-Minute-Remaining response header. Wait before retrying.
• 404 Not Found: The API or endpoint does not exist. Verify the IDs using the catalog.
• 5xx Server Error: Upstream API issue. Retry after a short delay (2-5 seconds).

Rate Limit Headers

Every API response includes these headers:

• X-Zyla-RateLimit-Minute-Limit: Max requests per minute
• X-Zyla-RateLimit-Minute-Remaining: Remaining requests this minute
• X-Zyla-API-Calls-Monthly-Used: Total calls this billing cycle
• X-Zyla-API-Calls-Monthly-Remaining: Remaining calls this cycle

Billing

• Pay-as-you-go: No monthly fee. Each API call is billed at the API's per-call rate.
• Billing happens at the end of each cycle via Stripe.
• Use the health endpoint to check current usage: npx tsx {baseDir}/scripts/zyla-api.ts health