---
title: "Import tar stream to supplied target"
method: POST
path: "/archive"
tags: ["storage"]
---

# Import tar stream to supplied target

`POST /archive`

Imports a tar stream to a device at the target path

## Query parameters

- `store` string, required
- `deviceID` string, required
- `filterSpec` string

## Response `200`

OK

## Other responses

- `404` — Supplied target not found
- `409` — Unexpected resource conflict
- `422` — Format error in supplied filter or archive
- `423` — Device or resource is locked
- `500` — failed to export tar archive from target
- `default` — error

## Changes

- **2018-06-14** `d95851b27556` — 1 info
  - added the new optional `header` request parameter `Op-ID` to all path's operations
- **2017-08-11** `2973344f3c68` — 1 info
  - added the non-success response with the status `409`
- **2017-07-17** `150ec5fb6b93` — 1 info
  - added the non-success response with the status `422`
- **2017-07-10** `5b1434eddd9c` — 1 info
  - endpoint added
- **2016-09-22** `cd3b04ac340a` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/vmware/apis/port-layer-api/changes/archive/post.md)

---

[API](https://skmtc.dev/vmware/apis/port-layer-api.md) · [All operations](https://skmtc.dev/vmware/apis/port-layer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vmware/port-layer-api/revisions/5fff0b8814c7/schema)