---
title: "Run progress and per-file problems"
method: GET
path: "/v1/workspaces/{workspaceId}/file-imports/runs/{runId}"
tags: ["File imports"]
---

# Run progress and per-file problems

`GET /v1/workspaces/{workspaceId}/file-imports/runs/{runId}`

## Request

- Base URL: `https://shareout.site`
- URL: `https://shareout.site/v1/workspaces/{workspaceId}/file-imports/runs/{runId}`
- Auth: HTTP bearer

## Response `200`

Run

- object
  - `run` FileImportRun
    - `id` string
    - `sourceId` string
    - `status` 'queued' | 'walking' | 'importing' | 'done' | 'stopped' | 'failed'
    - `trigger` 'manual' | 'resync' | 'schedule'
    - `counts` object
      - `found` integer
      - `imported` integer
      - `converted` integer
      - `skipped` integer
      - `unchanged` integer
      - `failed` integer
    - `stopCode` string, nullable: STORAGE_QUOTA_EXCEEDED, CONNECTION_REVOKED, RATE_LIMITED, WALK_LIMIT (warning on a done run), NOT_ALLOWED, SOURCE_DELETED, STALLED, FAILED.
    - `stopMessage` string, nullable
    - `createdAt` string, date-time
    - `finishedAt` string, date-time, nullable
    - `errors` object[]: Files that failed, were skipped, or imported with a warning (up to 200).
      - `path` string
      - `status` string
      - `code` string
      - `message` string

## Other responses

- `404`: Resource not found

## Changes

- **2026-10-17** `a43d748cfdda`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/shareout/apis/shareout-rest-api/changes/v1/workspaces/:workspaceId/file-imports/runs/:runId/get.md)

---

[API](https://skmtc.dev/shareout/apis/shareout-rest-api.md) - [All operations](https://skmtc.dev/shareout/apis/shareout-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/shareout/apis/shareout-rest-api/revisions/1e3f7fd34f6d?raw)