---
title: "Retry Document Processing"
method: POST
path: "/knowledge_bases/v2/{kb_id}/documents/{doc_id}/retry"
tags: ["Knowledge Bases V2"]
---

# Retry Document Processing

`POST /knowledge_bases/v2/{kb_id}/documents/{doc_id}/retry`

## Request

- Base URL: `https://api.myaltimate.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.myaltimate.com/knowledge_bases/v2/{kb_id}/documents/{doc_id}/retry`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Retry processing for a failed document.

This endpoint:
1. Validates the document exists and is in a failed state
2. Resets the document status to pending_ingestion
3. Queues a new Celery task for processing

Only documents with status: ingestion_failed, celery_failed, or airflow_failed can be retried.

## Path parameters

- `kb_id` integer, required
- `doc_id` integer, required

## Response `200`

Successful Response

- KnowledgeDocumentUploadResponse: Response after uploading a knowledge base document
  - `success` boolean, required
  - `document_id` integer, required
  - `document_public_id` string, required
  - `knowledge_base_id` integer, required
  - `version` integer, required
  - `processing_status` string, required
  - `celery_task_id` string, nullable
  - `message` string, nullable

## Other responses

- `400`: Document is not in a failed state
- `403`: Access denied
- `404`: Document not found
- `422`: Validation Error

---

[API](https://skmtc.dev/myaltimate/apis/myaltimate-api.md) - [All operations](https://skmtc.dev/myaltimate/apis/myaltimate-api/llms.txt) - [OpenAPI document](https://skmtc.dev/myaltimate/apis/myaltimate-api/revisions/727657ce54e9?raw)