frontend-query-mutation
Guide for implementing Langflow frontend query and mutation patterns with Axios and TanStack React Query v5. Trigger when creating or updating API hooks in controllers/API/queries, consuming UseRequestProcessor in components, deciding whether to use useQuery or useMutation, handling conditional queries, cache invalidation, mutation error handling, or migrating legacy API calls to the query hook pattern.
How do I install this agent skill?
npx skills add https://github.com/langflow-ai/langflow --skill frontend-query-mutationIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides architectural guidelines and code templates for frontend development in the Langflow project. It documents best practices for using Axios and TanStack React Query. No security issues were detected.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
Frontend Query & Mutation
Intent
- Keep API hooks in
controllers/API/queries/{domain}/as the organized source of truth. - Use
UseRequestProcessorfor consistent retry, invalidation, and error handling. - Use Axios
apiinstance for all HTTP calls (never rawfetchfor REST). - Use
performStreamingRequest()for streaming operations (build, chat). - Keep cache invalidation in mutation
onSettledcallbacks.
Architecture Overview
Langflow uses Axios + TanStack React Query v5 for data fetching. There is no oRPC or contract layer. The architecture is:
Component
-> API hook (controllers/API/queries/{domain}/use-{verb}-{resource}.ts)
-> UseRequestProcessor (controllers/API/services/request-processor.ts)
-> useQuery / useMutation (TanStack React Query)
-> queryFn / mutationFn
-> api.get/post/patch/delete (Axios instance from controllers/API/api.tsx)
Key Files
| File | Purpose |
|---|---|
controllers/API/api.tsx | Axios instance, ApiInterceptor component, performStreamingRequest() |
controllers/API/services/request-processor.ts | UseRequestProcessor hook wrapping useQuery/useMutation with retry defaults |
controllers/API/helpers/constants.ts | URL constants (URLs) and getURL() helper |
controllers/API/queries/{domain}/ | Domain-organized query and mutation hooks |
types/api/index.ts | useQueryFunctionType, useMutationFunctionType type helpers |
stores/ | Zustand stores for client-side state |
Workflow
- Identify the change surface.
- Read
references/query-patterns.mdfor hook structure, naming, URL patterns, and query/mutation call-site shape. - Read
references/runtime-rules.mdfor conditional queries, invalidation, error handling, and streaming. - Read both references when a task spans hook creation and runtime behavior.
- Read
- Implement the hook following existing patterns.
- Use
UseRequestProcessorforquery()andmutate()wrappers. - Use the
apiAxios instance for all HTTP calls. - Use
getURL()for constructing API paths. - Type the hook with
useQueryFunctionTypeoruseMutationFunctionType.
- Use
- Preserve Langflow conventions.
- Query keys are arrays with the hook name:
["useGetFlows"]. - Mutations invalidate related queries in
onSettled. - Zustand store updates happen in the query/mutation function, not in components.
UseRequestProcessorprovides default retry (5 for queries, 3 for mutations) with exponential backoff.
- Query keys are arrays with the hook name:
Files Commonly Touched
controllers/API/queries/{domain}/use-get-*.ts(query hooks)controllers/API/queries/{domain}/use-post-*.ts(create mutations)controllers/API/queries/{domain}/use-patch-*.ts(update mutations)controllers/API/queries/{domain}/use-delete-*.ts(delete mutations)controllers/API/helpers/constants.ts(URL constants)types/api/index.ts(API type definitions)stores/(Zustand store updates triggered by queries)
References
- Use
references/query-patterns.mdfor hook structure, naming conventions, directory layout, and anti-patterns. - Use
references/runtime-rules.mdfor conditional queries, invalidation,mutateversusmutateAsync, error handling, and streaming requests.
Treat this skill as the single query and mutation entry point for Langflow frontend work. Keep detailed rules in the reference files instead of duplicating them in project docs.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/langflow-ai/langflow/frontend-query-mutation">View frontend-query-mutation on skillZs</a>