api-troubleshooting

Diagnose API failures via log inspection, curl tests, and queue management.

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/billyfranklim1/claude-skills --skill api-troubleshooting
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-troubleshooting
Source: https://github.com/billyfranklim1/claude-skills/tree/main/plugins/api-troubleshooting/skills/api-troubleshooting
Command: npx skills add https://github.com/billyfranklim1/claude-skills --skill api-troubleshooting

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a focused runbook to diagnose and triage external and internal API failures that break background jobs, webhooks, and indexing pipelines, helping restore integrations quickly when timeouts, rate limits, authentication errors, or webhook delivery issues occur.

Core Features & Use Cases

  • Log-driven diagnosis: Walkthroughs to search Laravel logs, inspect failed jobs, and surface HTTP error patterns (429, 401, 403, 500).
  • Endpoint and quota checks: Curl-based health tests, latency breakdowns, API quota verification (e.g., Google Indexing), token validity checks for Meta Ads and other providers.
  • Webhook and connectivity debugging: Webhook replay, journalctl and tcpdump guidance, DNS/TLS validation, and artisan queue management to reproduce and remediate failures.
  • Use Case: When a NewsApp or MyApp background job silently fails calling Gemini or Google Indexing, use the steps to identify whether the root cause is quota exhaustion, token expiry, DNS/SSL issues, or transient network timeouts.

Quick Start

Inspect recent Laravel HTTP errors, run the curl health and latency checks against the affected API host, and review failed artisan jobs to determine whether the issue is a timeout, rate limit, or authentication problem.

Frequently Asked Questions about api-troubleshooting

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I troubleshoot API timeouts and rate limits in Laravel background jobs?

To troubleshoot API timeouts and rate limits in Laravel background jobs, inspect recent HTTP errors in Laravel logs, run curl-based latency checks against the affected API host, and review failed artisan jobs to determine whether the issue is quota exhaustion or transient network timeouts.

Why does my webhook delivery fail silently when calling third-party APIs like Gemini or Asaas?

Webhook delivery fails silently when calling third-party APIs like Gemini or Asaas due to token expiry, DNS issues, or TLS validation errors. Perform webhook replay checks, inspect journalctl logs, and capture outbound traffic using tcpdump to identify the connectivity failure.

What is the best way to diagnose HTTP 429 and 401 authentication errors in production web services?

The best way to diagnose HTTP 429 and 401 authentication errors in production web services is through log-driven diagnosis. Search Laravel logs for HTTP error patterns, verify API quotas, and perform token validity checks for specific providers like Meta Ads to surface the root cause.

Can I use curl to test API endpoint health and verify quotas for Google Indexing pipelines?

Yes, you can use curl to test API endpoint health and verify quotas for Google Indexing pipelines. Curl-based health tests provide latency breakdowns and verify API quota availability, helping determine if background job failures are caused by quota exhaustion or endpoint unavailability.

How do I debug DNS and TLS validation issues affecting external API integrations?

To debug DNS and TLS validation issues affecting external API integrations, perform DNS and TLS validation alongside outbound traffic capture using tcpdump. These steps identify whether SSL or DNS resolution failures are disrupting connectivity to external web services.

When should I replay webhooks and manage artisan queues during API failure triage?

You should replay webhooks and manage artisan queues during API failure triage when attempting to reproduce and remediate webhook delivery issues. Webhook replay checks and artisan queue management help verify if the delivery failure is transient or persistent after identifying initial root causes.