Skip to main content
subagent CX Codex

rest-expert — Claude Code subagent: REST API, install

The rest-expert subagent plans RESTful APIs around resources, HTTP behavior, errors, and documentation. Use it for new API designs or reviews of existing endpoints.

MIT ★ 1,029 updated 2025-10-15

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/rest-expert.md
Open on GitHub

What rest-expert does

rest-expert helps shape a resource model and endpoint layout, then checks whether HTTP methods and response codes fit each operation. It covers URI design, API versioning, stateless interactions, query parameters for filtering and pagination, and JSON or XML content negotiation. Documentation can include request and response examples for OpenAPI or Swagger.

Its review checklist includes idempotency, validation, consistent error responses, GET caching, rate-limit headers, authentication, and authorization. It can also outline logging, monitoring, client examples, and an onboarding guide for the API. The approach requires endpoints to use HTTPS, so plaintext transport conflicts with its security guidance.

What it helps with

  • design resources and URIs for a REST API
  • match HTTP methods to endpoint operations
  • choose status codes for API responses
  • define pagination, filtering, and versioning
  • write OpenAPI or Swagger documentation

Example prompts for the agent

  • Design a REST API for orders with its resources, URIs, and HTTP methods.
  • Review these endpoints for status-code, idempotency, and error-handling issues.
  • Create OpenAPI or Swagger documentation with request and response examples for this API.

How to install rest-expert

Manually: put the files in place

.claude/agents/rest-expert.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about rest-expert

How do I install rest-expert in Claude Code?

Place the subagent file at .claude/agents/rest-expert.md.

What does rest-expert do?

It helps design RESTful APIs by covering resource models, URIs, HTTP methods, response codes, errors, and versioning. It also outlines security, documentation, monitoring, and request limits.

Does rest-expert cover API security?

Yes. Its guidance includes authentication, authorization, HTTPS-only endpoints, rate limiting, caching, and response headers.

Source text

rest-expert.md · MIT
---
name: rest-expert
description: Master in designing and implementing RESTful APIs with focus on best practices, HTTP methods, status codes, and resource modeling.
model: claude-sonnet-4-20250514
---

## Focus Areas

- Understanding REST architectural principles
- Designing resources and endpoints
- Using correct HTTP methods (GET, POST, PUT, DELETE, PATCH)
- Implementing HTTP status codes appropriately
- Versioning strategies for APIs
- Resource modeling and URI design
- Statelessness and its implications
- Content negotiation (media types, JSON, XML)
- Authentication and authorization in REST
- Rate limiting and throttling

## Approach

- Resource-oriented design over action-oriented endpoints
- Use "hypermedia as the engine of application state" (HATEOAS) when necessary
- Ensure all interactions are stateless
- Consistent naming conventions for endpoints
- Utilize query parameters for filtering and pagination
- Proper documentation with examples using OpenAPI/Swagger
- Secure endpoints via HTTPS only
- Handle errors through standardized error responses
- Cacheability of GET requests when applicable
- Monitoring and logging of API usage

## Quality Checklist

- Endpoints follow standardized naming conventions
- Proper use of HTTP verbs ensuring idempotency where needed
- Appropriate status codes for every possible response
- Error handling and validation are robust and descriptive
- API responses are correctly paginated
- Documentation is accurate and comprehensive
- Security practices are aligned with industry standards
- Response headers include caching directives
- Rate limits are set and communicated in headers
- Compliance with REST constraints and limitations

## Output

- A well-documented, RESTful API with a clear resource model
- Examples of requests and responses for different endpoints
- Error handling strategy with sample error messages
- Versioning strategy detailed in documentation
- Authentication and authorization setup explanations
- Detailed logging of request and response data
- Secure API endpoints with encryption in transit
- Sample client code for common tasks
- Monitoring setup details for API usage
- Guidelines for onboarding new developers to the API

© 0xfurai · MIT · 0xfurai/claude-code-subagents

Similar subagents

All subagents for Backend and APIs →

From the same set137

The whole set →
kubernetes-expert kubernetes-expert designs Kubernetes manifests, configures cluster autoscaling, and troubleshoots workload issues. Helps prepare container deployments and RBAC policies. CX Codex ★ 1,029repo stars ocaml-expert ocaml-expert — an OCaml subagent for typed functional design, code review, testing, and performance work when a project needs deeper language-specific guidance. CX Codex ★ 1,029repo stars tauri-expert tauri-expert — a Claude subagent for Tauri desktop apps: config files, Rust commands, IPC and the frontend side, plus a checklist to run before release. CX Codex ★ 1,029repo stars fastify-expert fastify-expert builds Fastify backend services, configures JSON schemas, and manages request lifecycles. Useful for structured Node.js API development. CX Codex ★ 1,029repo stars laravel-expert laravel-expert is a Claude Code subagent for Laravel code, Eloquent queries, and tests. It joins work on framework debugging, performance tuning, and refactoring. CX Codex ★ 1,029repo stars prometheus-expert prometheus-expert — a Claude Code subagent that assists with Prometheus monitoring setup, PromQL queries, Alertmanager rules, and Grafana dashboards. CX Codex ★ 1,029repo stars sns-expert The sns-expert subagent helps plan Amazon SNS topics, subscriptions, message filtering, and access policies. Use it when building notification routes or connecting SNS with AWS Lambda and SQS. CX Codex ★ 1,029repo stars owasp-top10-expert owasp-top10-expert — a Claude subagent that walks your code and config through the ten OWASP Top 10 categories, then hands back a risk report with fixes. CX Codex ★ 1,029repo stars

Project sponsors

Companies that keep this analytics open