---
title: "POST /api/workspaces/{workspace_id}/import/async/"
method: POST
path: "/api/workspaces/{workspace_id}/import/async/"
tags: ["Workspaces"]
---

# POST /api/workspaces/{workspace_id}/import/async/

`POST /api/workspaces/{workspace_id}/import/async/`

Import a set of applications included in a given resource if the authorized user is in the specified workspace. This endpoint requires a valid resource_id of the uploaded file.

## Path parameters

- `workspace_id` integer, required

## Headers

- `ClientSessionId` string, uuid

## Response `202`

- ImportApplicationsJobTypeResponse
  - `id` integer, required
  - `type` string, required — The type of the job.
  - `progress_percentage` integer, required — A percentage indicating how far along the job is. 100 means that it's finished.
  - `state` string, required — Indicates the state of the import job.
  - `human_readable_error` string — A human readable error message indicating what went wrong.
  - `error_code` string — A machine readable error code indicating why the job failed.
  - `created_on` string, date-time, required
  - `updated_on` string, date-time, required
  - `installed_applications` unknown, required
  - `workspace_id` integer, required
  - `resource` ImportResource, required
    - `id` integer, required
    - `name` string, required
    - `size` integer — The size of the resource in bytes.

## Other responses

- `400`
- `404`

## Changes

- **2026-08-12** `ea4a3480f8d3` — 1 info
  - added the optional property `error_code` to the response with the `202` status

[Change history](https://skmtc.dev/baserow/apis/baserow-api-spec/changes/api/workspaces/:workspace_id/import/async/post.md)

---

[API](https://skmtc.dev/baserow/apis/baserow-api-spec.md) · [All operations](https://skmtc.dev/baserow/apis/baserow-api-spec/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/baserow/baserow-api-spec/revisions/f3396317d932/schema)