Project Operations: Import API Definitions

Overview

After creating a project, the next operation is importing the API definition. Shift Left Studio supports both local file upload and hosted Swagger/OpenAPI URL import.

This step builds the endpoint inventory used for test generation, execution, and reporting.

Method A: Import via file upload

Use file upload when the API specification is available on your local machine.

1. In the Import API dialog, select Upload File.
2. Provide the spec using one of these options:
   • drag and drop a .json, .yaml, or .yml file
   • select Click to Browse and choose the file
3. Select Import to parse the specification.

Supported formats include OpenAPI 2.0 (Swagger) and OpenAPI 3.x in JSON or YAML.

Method B: Import via Swagger/OpenAPI URL

Use URL import when the specification is hosted and accessible through HTTP/HTTPS.

1. In the Import API dialog, switch to the URL tab.
2. Enter the full specification URL (for example, https://example.com/swagger.json).
3. Select Import to fetch and parse the remote document.

Confirm endpoint discovery

After import completes, Shift Left Studio shows the discovered endpoints.

• Review endpoint count and paths.
• Confirm method/path coverage for critical resources.
• Select Close to continue into the project dashboard.

If expected endpoints are missing, re-check the source specification for completeness and validity.

Next in the workflow

• Navigate features and endpoints: Managing projects
• Validate endpoints: Validate endpoints
• Generate and run tests: Generate endpoint test cases and Run tests and review results
• Tune project behavior: Project settings

Related articles

• Project
• Project settings
• Managing projects