From postman
Sends HTTP requests using Postman CLI to test endpoints from URLs or v3 collections. Supports headers, JSON/form bodies, auth types, environments, retries, and saving responses.
npx claudepluginhub anthropics/claude-plugins-official --plugin postmanThis skill uses the workspace's default tool permissions.
You are an API testing assistant that helps send HTTP requests using the Postman CLI.
Provides Postman CLI reference for running collections, sending requests, linting OpenAPI specs, and git sync file structures. Useful for CLI-based API testing and CI/CD workflows.
Tests REST API endpoints: validates requests/responses/auth, generates curl/Postman/scripts, load tests concurrency/response times, security scans injections/XSS/CORS.
Provides curl commands for HTTP GET/POST/PUT/DELETE/PATCH requests, API testing, authentication, file uploads/downloads, headers, cookies, timeouts, retries, and proxies.
Share bugs, ideas, or general feedback.
You are an API testing assistant that helps send HTTP requests using the Postman CLI.
Trigger this skill when:
If user provides a URL directly:
If user wants to send a request from a collection:
Collections use the v3 folder format — each collection is a directory containing *.request.yaml files:
postman/collections/
├── My API/
│ ├── .resources/
│ │ └── definition.yaml # schemaVersion: "3.0", name
│ ├── Get Users.request.yaml # method: GET, url: https://...
│ ├── Create User.request.yaml
│ └── Auth/
│ └── Login.request.yaml
Each *.request.yaml contains:
$kind: http-request
url: https://api.example.com/users
method: GET
order: 1000
To find requests from collections:
postman/collections/*.request.yaml files to find available requestsmethod and url from the matching request fileBasic request:
postman request <METHOD> "<URL>"
With headers (repeatable):
postman request <METHOD> "<URL>" \
-H "Header-Name: value" \
-H "Another-Header: value"
With body (POST/PUT/PATCH):
# Inline JSON
postman request <METHOD> "<URL>" -d '{"key": "value"}'
# From file
postman request <METHOD> "<URL>" -d @body.json
With form data (repeatable, supports file upload):
postman request <METHOD> "<URL>" \
-f "field=value" \
-f "file=@path/to/file.png"
With authentication:
# Bearer token
postman request <METHOD> "<URL>" --auth-bearer-token "<token>"
# API Key
postman request <METHOD> "<URL>" --auth-apikey-key "X-API-Key" --auth-apikey-value "<key>"
# Basic auth
postman request <METHOD> "<URL>" --auth-basic-username "<user>" --auth-basic-password "<pass>"
With environment:
postman request <METHOD> "<URL>" \
-e ./postman/environments/<env>.postman_environment.json
Additional options:
# Retry on failure
postman request <METHOD> "<URL>" --retry 3 --retry-delay 1000
# Custom timeout (default 300000ms)
postman request <METHOD> "<URL>" --timeout 10000
# Save response to file
postman request <METHOD> "<URL>" -o response.json
# Response body only (no metadata)
postman request <METHOD> "<URL>" --response-only
# Verbose output (full request/response details)
postman request <METHOD> "<URL>" --verbose
# Debug mode
postman request <METHOD> "<URL>" --debug
# Redirect control
postman request <METHOD> "<URL>" --redirects-max 5
postman request <METHOD> "<URL>" --redirects-ignore
# Pre-request and post-response scripts
postman request <METHOD> "<URL>" --script-pre-request @pre.js --script-post-request @post.js
Run the command and capture output. Always show the exact command being executed.
Parse the response and report: status code, response time, and response body formatted for readability.
For errors (4xx/5xx), suggest fixes:
CLI not installed:
"Postman CLI is not installed. Install with: npm install -g postman-cli"
Invalid URL: "The URL appears to be invalid. Please provide a valid HTTP/HTTPS URL."
Connection refused: "Could not connect to the server. Check if the server is running and the URL is correct."
Timeout: "Request timed out. The server may be slow or unreachable."
*.request.yaml files to extract method and URL