---

name: api-patterns description: Connect Query patterns for API calls. Use when working with mutations, queries, or data fetching.

API Patterns

Make API calls with Connect Query and handle responses properly.

Activation Conditions

• Making API calls
• Using Connect Query hooks
• Cache invalidation
• Mutations and optimistic updates
• Toast notifications for errors

Quick Reference

Key Locations

Regenerate protos: task proto:generate (from repo root)

Basic Patterns

Query

Copyimport { useQuery } from '@connectrpc/connect-query';
import { getUser } from 'protogen/user-UserService_connectquery';

const { data, isLoading, error } = useQuery(
  getUser,
  { id: userId },
  { enabled: !!userId }
);

Mutation

Copyimport { useMutation } from '@connectrpc/connect-query';
import { createUser } from 'protogen/user-UserService_connectquery';

const mutation = useMutation(createUser, {
  onSuccess: () => {
    queryClient.invalidateQueries({ queryKey: ['getUser'] });
  },
});

mutation.mutate({ name, config });

Rules

See rules/ directory for detailed guidance.