> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usedragonfly.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Importing

> Bring over Postman, Thunder Client, Insomnia, HAR, OpenAPI or cURL, with folders and details intact.

Already have your requests somewhere else? Bring them with you. One **Import Collection** command detects the format and pulls in folders, headers, params, bodies and environments intact, so `{{baseUrl}}` resolves right away.

<Note>
  Live credentials are left out on purpose. Re-add them with the [authentication](/guides/authentication) options after importing.
</Note>

## Supported sources

<CardGroup cols={2}>
  <Card title="Postman" icon="https://mintcdn.com/saurabh-dc2af1a9/2Gj8GymSTIUjWURc/icons/rocket.svg?fit=max&auto=format&n=2Gj8GymSTIUjWURc&q=85&s=11161752c93bd30339014cbafaec59a2" width="24" height="24" data-path="icons/rocket.svg">
    Collections in v1 and v2 format, with folders, requests, headers, query params and bodies preserved.
  </Card>

  <Card title="Thunder Client" icon="https://mintcdn.com/saurabh-dc2af1a9/2Gj8GymSTIUjWURc/icons/bolt.svg?fit=max&auto=format&n=2Gj8GymSTIUjWURc&q=85&s=0c8f0744776d21dea27a8ffed7b710a9" width="24" height="24" data-path="icons/bolt.svg">
    Collections and environments come across.
  </Card>

  <Card title="Insomnia" icon="https://mintcdn.com/saurabh-dc2af1a9/2Gj8GymSTIUjWURc/icons/moon.svg?fit=max&auto=format&n=2Gj8GymSTIUjWURc&q=85&s=54337e336ccff4bde5062e10bd28904d" width="24" height="24" data-path="icons/moon.svg">
    Collections and environments come across.
  </Card>

  <Card title="HAR captures" icon="https://mintcdn.com/saurabh-dc2af1a9/2Gj8GymSTIUjWURc/icons/file-down.svg?fit=max&auto=format&n=2Gj8GymSTIUjWURc&q=85&s=4a37084d237c3f1f95e5702d45a54039" width="24" height="24" data-path="icons/file-down.svg">
    Import a HAR file saved from your browser devtools.
  </Card>

  <Card title="OpenAPI and Swagger" icon="https://mintcdn.com/saurabh-dc2af1a9/2Gj8GymSTIUjWURc/icons/file-code.svg?fit=max&auto=format&n=2Gj8GymSTIUjWURc&q=85&s=a2979104e8be50a675e09cbca7c13936" width="24" height="24" data-path="icons/file-code.svg">
    One request per operation, grouped into folders by tag, with path params turned into `{{variables}}`.
  </Card>

  <Card title="cURL" icon="https://mintcdn.com/saurabh-dc2af1a9/2Gj8GymSTIUjWURc/icons/terminal.svg?fit=max&auto=format&n=2Gj8GymSTIUjWURc&q=85&s=b6b80dccf46a216b188f2fad1c618d42" width="24" height="24" data-path="icons/terminal.svg">
    Paste a cURL command and the request form fills itself in.
  </Card>
</CardGroup>

## Import a collection

<Steps>
  <Step title="Run Import Collection">
    Open the Command Palette and run **Import Collection**, then point it at your file. The format is detected for you.
  </Step>

  <Step title="Review the result">
    Folders, headers, query params and bodies come across intact, and environments are brought in so `{{variable}}` values resolve.
  </Step>

  <Step title="Re-add secrets">
    Live credentials are not imported. Add them back with the [authentication](/guides/authentication) options.
  </Step>
</Steps>

## Import from cURL

Paste a cURL command from Postman, browser devtools, Swagger UI or a docs page, and Dragonfly fills in the method, URL, headers and body for you.

```bash theme={null}
curl https://api.example.com/users \
  -H "Authorization: Bearer <token>" \
  -H "Accept: application/json"
```

## Environments

Postman, Thunder Client and Insomnia environments are imported alongside their collections. That means a `{{baseUrl}}` in an imported request resolves as soon as the environment is active. See [Collections and environments](/guides/collections-environments).