Import and export
Import
Section titled “Import”Open Import from the + button (New collection), Home, Menu › File, or Quick search.
| Source | What Codestamp reads |
|---|---|
| Postman Collection v2.0 and v2.1 | The collection and its environment files |
| OpenAPI 3 and Swagger 2 | JSON or YAML, from a file or a URL |
| cURL | A command pasted from “Copy as cURL”, in bash or Windows cmd |
| WSDL | A file or a URL |
Postman
Section titled “Postman”Codestamp shows a preview before it imports: the number of requests, sections, scripts and variables, and a list of things to review.
- Top-level folders become sections. Nested folders become names such as
Folder / Sub / Request. - Bearer and API key auth become a header or a parameter. Basic becomes a header, or a pre-request script when it uses variables. Auth inherited from a collection or folder is applied.
- Collection and folder scripts are merged in front of the request’s script, in Postman’s order of execution.
- Raw, JSON, urlencoded, form-data, file and GraphQL bodies are converted.
- Upload file paths are not imported, and neither are unsupported dynamic variables. Codestamp reports both as warnings.
- Secret-type variables stay encrypted secrets.
- Descriptions of the collection, folders and requests come along.
OpenAPI and Swagger
Section titled “OpenAPI and Swagger”Tags become sections, path parameters become path variables, and body and response examples come along. Descriptions are imported from the info, tags and operations. Codestamp reads YAML with a limit on aliases, which guards against “billion laughs”. A URL must be HTTPS, or localhost.
Paste the command, check how Codestamp parsed it, and add it to any collection or section. -F and --form-string become a form data body, and you pick the files again.
A WSDL becomes a new collection with one SOAP request per operation. See SOAP requests.
Replace the content of a collection
Section titled “Replace the content of a collection”A Postman or OpenAPI file can replace what is inside an existing collection. Sections, requests, auth, docs and variables are replaced. The id, name, icon and team link stay. Codestamp asks first and shows the old and new number of requests. For a shared collection, the replacement goes out as an ordinary commit on the next sync, so the old version stays in Git history.
Export
Section titled “Export”The Export button in a collection header opens the Export panel for that collection. Pick a format from the dropdown:
- Codestamp, for other Codestamp users: every request type, examples, Docs and the collection’s environments.
- Postman Collection v2.1, for Postman, Insomnia, Bruno and other tools. Sections become folders, auth, scripts and variables come along, and WebSocket requests are skipped.
- Docs as Markdown.
Environments and Globals export from the Environments page as Postman environment files.
Exports leave secret values and restricted values out, and they hold no local file paths. For an upload, only the file name is kept. Codestamp tells you when it skipped or emptied something. A Codestamp file gets new ids on import, so you can import it next to the collection it came from.
Back up everything
Section titled “Back up everything”To save all your data to one file, use Settings › Data & history. See Settings.