---
title: "List imports"
method: GET
path: "/import/runs/{workspaceId}"
tags: ["Import"]
---

# List imports

`GET /import/runs/{workspaceId}`

## Request

- Base URL: `https://cloud.kaneo.app/api`
- URL: `https://cloud.kaneo.app/api/import/runs/{workspaceId}`
- Auth: HTTP bearer

The workspace's 20 most recent imports, newest first. A run whose server stopped reporting progress is returned as failed.

## Path parameters

- `workspaceId` string, required

## Response `200`

Recent imports

- ImportRunList
  - `runs` ImportRun[], required
    - `id` string, required
    - `workspaceId` string, required
    - `source` 'planka' | 'plane' | 'linear' | 'jira' | 'trello' | 'kaneo', required
    - `status` 'running' | 'completed' | 'failed', required: completed once every selected project was attempted, even if some failed; check each project's status. failed means the run itself stopped.
    - `includeComments` boolean, required
    - `message` string, nullable, required: Latest progress line while the run is running.
    - `error` string, nullable, required
    - `projects` ImportRunProject[], required
      - `sourceId` string, required
      - `name` string, required
      - `status` 'pending' | 'running' | 'completed' | 'failed', required
      - `projectId` string, nullable, required: The Kaneo project created by the import, once completed.
      - `projectSlug` string, nullable, required
      - `counts` ImportCounts, required
        - `columns` integer, required
        - `tasks` integer, required
        - `labels` integer, required
        - `comments` integer, required
        - `assignees` integer, required: Tasks that were assigned to a workspace member.
        - `relations` integer, required
      - `warnings` string[], required
      - `error` string, nullable, required
    - `createdAt` string, date-time, required
    - `finishedAt` string, date-time, nullable, required

## Other responses

- `401`: Missing or invalid credentials
- `403`: Missing workspace:manage_settings or project:create permission
- `404`: Workspace not found
- `429`: The API key exceeded its rate limit or usage quota. Wait the number of seconds in Retry-After before retrying. The X-RateLimit headers are sent only when the rate limit was hit.

## Changes

- **2026-10-11** `269feaac2cc4`: 1 info
  - endpoint added
- **2026-10-11** `4cb086e51a1a`: 1 breaking
  - api path removed without deprecation
- **2026-10-11** `f701bf7cf2d9`: 1 warning
  - added the new `jira` enum value to the `runs/items/source` response property for the response status `200`
- **2026-10-11** `ec2dabb1d0cc`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/usekaneo/apis/kaneo-api/changes/import/runs/:workspaceId/get.md)

---

[API](https://skmtc.dev/usekaneo/apis/kaneo-api.md) - [All operations](https://skmtc.dev/usekaneo/apis/kaneo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/usekaneo/apis/kaneo-api/revisions/93f78789100c?raw)