---
title: "Cancel Import"
method: POST
path: "/v2/imports/{import_id}/cancel"
tags: ["imports"]
---

# Cancel Import

`POST /v2/imports/{import_id}/cancel`

## Request

- Base URL: `https://api.hud.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.hud.ai/v2/imports/{import_id}/cancel`
- Auth: none declared

Request cancellation of a live import; one that has ended is returned unchanged.

## Path parameters

- `import_id` string, uuid, required

## Response `200`

Successful Response

- ImportResponse
  - `id` string, uuid, required
  - `format` 'harbor', required
  - `taskset_id` string, uuid, required
  - `file` ImportFile, required
    - `id` string, uuid, required
    - `filename` string, required
    - `size_bytes` integer, required
  - `status` 'queued' | 'starting' | 'running' | 'cancelling' | 'completed' | 'stopped' | 'failed' | 'cancelled', required: `stopped`: the importer refused the bundle or stopped partway, and its report says why; `failed`: the import did not run to an outcome
  - `summary` string, nullable: The importer's account of the outcome; set once completed or stopped
  - `metrics` object, nullable: Named counts the importer reports, e.g. `tasks_imported`; set with `summary`
  - `error` string, nullable: Why a failed import failed
  - `created_at` string, date-time, required
  - `completed_at` string, date-time, nullable: Null while the import is live

## Other responses

- `400`: Invalid or malformed request
- `401`: Missing or invalid credentials
- `403`: Caller may not access this resource
- `404`: Referenced entity does not exist
- `409`: Resource already exists
- `422`: Validation Error
- `429`: Rate limit exceeded; wait at least Retry-After seconds
- `503`: The server is at capacity; retry after Retry-After seconds

## Changes

- **2026-10-11** `61e27d1992f5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hud/apis/hud-platform/changes/v2/imports/:import_id/cancel/post.md)

---

[API](https://skmtc.dev/hud/apis/hud-platform.md) - [All operations](https://skmtc.dev/hud/apis/hud-platform/llms.txt) - [OpenAPI document](https://skmtc.dev/hud/apis/hud-platform/revisions/d642039f5fa6?raw)