beval/roster
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 4 Wiki Activity
Page: Import
Pages
API Reference Architecture Backup Contributing Development Export FAQ Getting Started History Home Import Installation Keyboard Shortcuts Projects and Environments Scripts Sensitive Variables Translation Variables
Clone
3
Import
Pavel Baksy edited this page 2026-05-19 14:53:49 +02:00
Table of Contents

Import

Roster can import API definitions from OpenAPI/Swagger and WSDL endpoints, automatically creating saved requests for all discovered operations.

Supported Formats

OpenAPI / Swagger

  • OpenAPI 2.0 (Swagger) — JSON or YAML
  • OpenAPI 3.x — JSON or YAML

Imports all defined API operations as separate saved requests, including:

  • HTTP method and path
  • Base URL from host/servers field
  • Request headers (Content-Type, Accept)
  • JSON body template generated from the request schema

WSDL (Web Services Description Language)

  • WSDL 1.1
  • WSDL 2.0

Imports all defined operations as SOAP requests, including:

  • Endpoint URL from the WSDL binding
  • Content-Type: text/xml header
  • XML body template generated from the input message schema, with correct namespace prefixes for each element — including WCF services that use DataContract types defined in a separate namespace

How to Import

OpenAPI / Swagger

Import from OpenAPI dialog

  1. Click the Import button (papyrus icon) in the sidebar toolbar
  2. Select "Import from OpenAPI / Swagger"
  3. Enter the Spec URL of the OpenAPI/Swagger definition (must start with http:// or https://)
  4. Click Fetch — Roster downloads and parses the spec
  5. Select the operations you want to import (or select all)
  6. Choose or create a project to import into
  7. Click "Import"

WSDL

  1. Click the Import button (papyrus icon) in the sidebar toolbar
  2. Select "Import from WSDL"
  3. Enter the WSDL URL of the service description (WSDL 1.1 or 2.0)
  4. Click Fetch WSDL — Roster downloads and parses the service description
  5. Select the operations you want to import (or select all)
  6. Choose or create a project to import into
  7. Click "Import"

The imported requests are saved to the selected project and ready to send.

Tips

  • Imported requests use placeholder values from the schema (e.g., empty strings for required fields). Fill in actual values before sending.
  • Variable substitution works in imported requests — add {{variable_name}} to the URL or body after importing.
  • For OpenAPI imports with {{server}} or similar base URL variables, set up an environment with the actual server URL.

Next Steps