OpenAPI
Browse an OpenAPI or Swagger spec as searchable endpoint cards, and build a runnable curl for any call.
The OpenAPI editor opens .openapi files — an OpenAPI 3.x or Swagger 2.0 API
description written in either JSON or YAML.
- Explore lists every operation as a searchable card — method, path, summary, parameters, request body, and responses. Search matches the method, path, summary, operation id, and tags.
- Raw is the underlying source with syntax highlighting, search, history, and folding. JSON and YAML are detected automatically.
Building a request
Section titled “Building a request”Each card assembles a curl command from the values you enter, and shows a live preview of it:
- Fill in path, query, and header parameters, and edit the request body — the preview under the card updates as you type.
- Set a shared Base URL once (for example
http://localhost:8080) and every card targets it. It starts from the spec’s firstserverand follows it until you change it. - Copy as curl puts the command on your clipboard.
- Try it runs the request and shows the response inline. It appears only in the Mac app, which has a native curl to send with; on the web, use Copy as curl. Either way the request is made by curl directly — it never passes through Worktray.
Parameters you leave blank stay as {name} placeholders in the command, so the
shape of the request is always visible even before you fill it in.
Which files open here
Section titled “Which files open here”Only files named *.openapi open in this editor. A spec saved as
openapi.yaml or swagger.json opens in the YAML or
JSON editor instead — rename it to end in .openapi to use
this view.
Undo and redo
Section titled “Undo and redo”Cmd/Ctrl+Z and Cmd/Ctrl+Shift+Z undo and redo the source. See Getting started for the full model.