- Home
- /
- Categories
- /
- API Dev
API Dev
API design, REST, GraphQL
Uses and selection guide
Use these skills when designing service interfaces, changing data models or integrating identity and cache layers. Check the supported database or provider, migration behavior and required credentials before choosing a workflow.
sse-resilience
by majiayu000
Redis-backed SSE stream management with stream registry, heartbeat monitoring, completion store for terminal events, and automatic orphan cleanup via background guardian process.
sse-resilience
by majiayu000
Redis-backed SSE stream management with stream registry, heartbeat monitoring, completion store for terminal events, and automatic orphan cleanup via background guardian process.
error-handling
by dadbodgeoff
Implement consistent error handling with custom error classes, error boundaries, and structured error responses. Covers logging, monitoring, and user-friendly messages.
api-client
by dadbodgeoff
Centralized TypeScript API client with typed namespaces, automatic token refresh with request deduplication, TanStack Query integration, and consistent error handling.
api-versioning
by dadbodgeoff
Implement API versioning strategies for backward compatibility. Covers URL versioning, header versioning, and deprecation workflows.
data-transformers
by dadbodgeoff
Centralized transformation logic for consistent data shaping across API routes. Includes aggregators, rankers, trend calculators, and data sanitizers.
pagination
by dadbodgeoff
Implement cursor-based and offset pagination for APIs. Covers efficient database queries, stable sorting, and pagination metadata.
idempotency
by dadbodgeoff
Implement idempotent API operations to safely handle retries and prevent duplicate processing. Use when building payment APIs, order systems, or any operation that must not be executed twice.
atomic-matchmaking
by dadbodgeoff
Two-phase commit matchmaking that verifies both player connections before creating a match. Handles disconnections gracefully with automatic re-queue of healthy players.
grpc-expert
by personamanagmentlayer
Expert-level gRPC, Protocol Buffers, microservices communication, and streaming
graphql-api-design
by williamzujkowski
Comprehensive GraphQL API design with Apollo Server, GraphQL Yoga, and Federation v2
graphql-expert
by personamanagmentlayer
Expert-level GraphQL API development with schema design, resolvers, and subscriptions
openapi-expert
by personamanagmentlayer
Expert-level OpenAPI/Swagger specification for API design, documentation, and code generation
microservices-expert
by personamanagmentlayer
Expert-level microservices architecture, patterns, service mesh, and distributed systems
fastapi-expert
by personamanagmentlayer
Expert-level FastAPI development for high-performance Python APIs with async support
api-design-expert
by personamanagmentlayer
Expert-level API design principles, REST, GraphQL, versioning, and API best practices
hindsight-memory
by vectorize-io
Long-term memory for the agent via Hindsight. Use to recall relevant past context before answering, retain durable facts as you learn them, and reflect over accumulated memory for the "why" behind a decision. Load whenever continuity across sessions matters — the user refers to earlier work, states a lasting preference, or asks a question that prior context could answer.
improving-drf-endpoints
by PostHog
Use when editing, reviewing, or auditing DRF viewsets and serializers in PostHog. Triggers on files in posthog/api/, products//backend/api/, products//backend/presentation/, or any file importing rest_framework. Covers field typing, schema annotations, enum collision fixes, and OpenAPI spec quality — everything that flows downstream into generated TypeScript types and MCP tools.
downloading-batch-export-files
by PostHog
Export PostHog events, persons, sessions, or the results of a HogQL query on demand and download the resulting files. Use when the user asks to download/export raw PostHog data, export HogQL query results, create a one-off file export, fetch a Parquet or JSONLines export, or use the file_download_batch_exports API. Covers starting the export with MCP, polling completion, and downloading via the existing REST redirect endpoint.
adding-personhog-rpc
by PostHog
Guide for adding a new RPC to personhog-replica and personhog-router. Covers eligibility checks, proto definition, code generation for Python and Node.js clients, Rust implementation (storage trait, postgres queries, service handler, router wiring), and index compatibility validation. Use when adding a new gRPC endpoint to personhog, migrating a Django ORM query to personhog, or extending the personhog service API.
auditing-warehouse-source-coverage
by PostHog
Audit already-implemented Data warehouse import sources for endpoints, schemas, and tables the vendor's API offers but we never wired up. Use when asked whether a source is missing endpoints, to find new endpoints a vendor has added since a source was built, to refresh COVERAGE_GAPS.md, to prioritize which source to deepen next, or to check coverage before an integration review. Covers dumping our real endpoint inventory credential-free, ranking sources by production adoption, diffing against vendor OpenAPI/GraphQL specs, and recording findings. Not for implementing a source (use implementing-warehouse-sources), adding a vendor API version (warehouse-source-new-version), or writing source docs (documenting-warehouse-sources).
setting-up-support-slack-locally
by PostHog
Connect a real Slack workspace to local PostHog Conversations (the SupportHog Slack app) so Slack messages become support tickets and replies post back. Use when the user wants to test the conversations Slack integration locally, hits "Support Slack OAuth client ID is not configured", gets a white screen or "Network error" on the OAuth callback, or asks how to set SUPPORT_SLACK_APP_CLIENT_ID / a tunnel for supporthog Slack events. Covers the Slack app + scopes, the SUPPORT_SLACK_* dynamic settings, and the key split: localhost for OAuth and the UI, a public tunnel only for inbound events.
using-redis-token-buckets
by PostHog
'Use when adding a bucket-like rate limit backed by Redis: a per-caller budget with burst capacity and continuous refill, a refund path for requests that did no work, or a limit whose Retry-After must be a real wait rather than a window edge. posthog/token_bucket.py provides an atomic Lua token bucket (consume, refund, peek) over posthog.redis.get_client(). Choose it over DRF SimpleRateThrottle/fixed-window cache counters when boundary bursts, top-of-window lockouts, or charge-then-refund semantics matter. Trigger terms: token bucket, rate limit, burst, refill, quota, Retry-After, fixed window, throttle.'
adding-project-secret-api-key-auth
by PostHog
'How to gate a PostHog API endpoint with project secret API key (PSAK) auth — a project-scoped, user-less service credential. Use when adding PSAK support to a viewset action, allowing a new scope for PSAKs, handling synthetic users (ProjectSecretAPIKeyUser), or choosing PSAK-aware rate throttles. Trigger terms: PSAK, ProjectSecretAPIKey, project secret API key, phs_ token, service auth, programmatic endpoint auth.'