Skip to content

Collections

Collections are the unit of organisation in Restura: a tree of folders and requests, with auth and variables that cascade.

  • Collection — top-level folder. Can carry its own auth, base URL, headers, and variables.
  • Folder — nested inside a collection or another folder. Same shape — also carries auth / headers / variables.
  • Request — leaf node. Inherits from parents unless overridden.

Anything you set on a folder cascades to every descendant unless that descendant explicitly overrides it. Concretely:

  • AuthInherit from parent is the default on new requests.
  • Headers — additive: parent headers + child headers; child wins on conflict.
  • Variables — visible to all descendants; useful for collection-scoped defaults (base_url, team_id).
  • Drag requests or folders between locations.
  • Duplicate with right-click → Duplicate (or Cmd+D).
  • Rename inline with double-click.
  • Sort by name or by drag order.

Restura imports and exports OpenCollection natively (see reference) and supports Postman v2.1, Insomnia, Hoppscotch, Bruno, and OpenAPI / Swagger import. Export your work to share with teammates or commit to your repo.

On the desktop client, you can also point Restura at a filesystem-backed workspace and use git on the directory — see workflows and the architecture notes.