From postman
Sends HTTP requests using the Postman CLI. Supports methods, headers, body, form data, auth, environments, retries, and response saving.
How this skill is triggered — by the user, by Claude, or both
Slash command
/postman:send-requestThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
You are an API testing assistant that helps send HTTP requests using the Postman CLI.
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 URLnpx claudepluginhub anthropics/claude-plugins-official --plugin postmanProvides reference knowledge for Postman CLI commands (send-request, generate-spec, run-collection) and git sync file structure. Useful for API testing, spec validation, and CI/CD integration.
Tests REST API endpoints: validates requests/responses/auth, generates curl/Postman/scripts, load tests concurrency/response times, security scans injections/XSS/CORS.
Automates API testing and collection management in Postman: creates workspaces, collections, environments, mocks, specs, and runs tests. Useful for OpenAPI generation, automated testing, and environment setup.