Table of Contents
Export
Roster can export requests to other formats for use with command-line tools or other HTTP clients.
Supported Formats
cURL
Export requests as cURL commands for use in terminal or scripts.
Example output:
curl -X POST 'https://api.example.com/users' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer token123' \
-d '{"name":"John","email":"john@example.com"}'
Other Formats
Additional export formats (HTTPie, wget, etc.) may be added in future releases.
How to Export
Export Current Request
- Configure your request in the request editor
- Click the Export button in the toolbar
- Select export format (e.g., "cURL")
- Exported command is copied to clipboard
Export from History
- Open a request from History
- Click the Export button
- Select format
- Command copied to clipboard
Export Saved Requests
- Open a saved request from project
- Click the Export button
- Select format
- Command copied to clipboard
Variable Substitution
When exporting requests that contain variables:
Variables are substituted with current environment values:
{{base_url}}replaced with actual URL{{api_key}}replaced with actual key value- All
{{variable}}placeholders resolved
The exported command contains the final values, not the placeholder syntax.
Sensitive Variables
Sensitive-Variables are exported with their actual decrypted values. Be careful when sharing exported commands containing sensitive data.
Security note: Exported cURL commands may contain:
- API keys in headers
- Passwords in request body
- Tokens in authorization headers
Review exported commands before sharing.
Using Exported Commands
cURL
Paste the exported cURL command in your terminal:
curl -X GET 'https://api.example.com/users' \
-H 'Authorization: Bearer token123'
Scripts
Use exported commands in shell scripts:
#!/bin/bash
# exported_request.sh
curl -X POST 'https://api.example.com/users' \
-H 'Content-Type: application/json' \
-d '{"name":"John"}'
Documentation
Include exported commands in API documentation or tutorials.
Export Features
Headers
All request headers are included in export:
- Custom headers
- Content-Type
- Authorization
- User-Agent
- etc.
Request Body
Request body is included with appropriate flags:
-dfor POST data- Properly escaped JSON
- Multiline bodies formatted correctly
Method
HTTP method included with -X flag:
-X GET-X POST-X PUT-X DELETE
Limitations
- Only cURL format currently supported
- No batch export of multiple requests
- Exported to clipboard only (no file export)
- Scripts (preprocessing/postprocessing) are not exported
Tips
Test exported commands: Always test exported cURL commands in a safe environment before using in production.
Redact sensitive data: Remove or replace sensitive values before sharing exported commands:
# Original export
curl -H 'Authorization: Bearer abc123xyz'
# Redacted for sharing
curl -H 'Authorization: Bearer YOUR_TOKEN_HERE'
Save to file: Redirect clipboard content to file:
# Paste from clipboard and save
pbpaste > request.sh # macOS
xclip -o > request.sh # Linux with xclip
Next Steps
- Getting-Started - Learn to create requests
- Variables - Use variables in requests
- History - Review past requests