Retry uploaded file

Interface Description

Manually retry one uploaded Markdown file that failed processing.

Endpoint

Field	Value
Method	POST
Path	/openapi/v2/knowledge-bases/{knowledgeBaseId}/source-files/{sourceFileId}/retry
Operation ID	retryKnowledgeBaseSourceFile
Authentication	Bearer OpenAPI key

Parameters

Name	Location	Required	Type	Example	Description
knowledgeBaseId	path	Yes	string	knowledge-base-11111111-1111-4111-8111-111111111111	Knowledge-base identifier returned by knowledge-base APIs.
sourceFileId	path	Yes	string	source-file-11111111-1111-4111-8111-111111111111	Uploaded-file identifier returned by upload or uploaded-file list APIs.

Request Body

This operation has no request body.

Request Example

curl -X POST "https://openapi.example.com/openapi/v2/knowledge-bases/knowledge-base-11111111-1111-4111-8111-111111111111/source-files/source-file-11111111-1111-4111-8111-111111111111/retry" \
  -H "Authorization: Bearer <openapi-key>"

Successful Responses

202

Uploaded file and accepted retry details.

Field	Required	Type	Description
sourceFile	Yes	object	Uploaded Markdown file returned by the request.
retry	Yes	object	Retry request accepted by the server.

Success Response Example

{
  "sourceFile": {
    "sourceFileId": "source-file-11111111-1111-4111-8111-111111111111",
    "knowledgeBaseId": "knowledge-base-11111111-1111-4111-8111-111111111111",
    "directoryId": "directory-11111111-1111-4111-8111-111111111111",
    "name": "guide.md",
    "relativePath": "handbook/guide.md",
    "generatedPath": "pages/handbook/guide.md",
    "contentType": "text/markdown; charset=utf-8",
    "sizeBytes": 1024,
    "resourceRevision": 1,
    "contentRevision": 1,
    "state": "waiting",
    "workProgress": {
      "required": 8,
      "completed": 0,
      "activeKinds": [],
      "blockingKind": "prepare",
      "retryingKind": null
    },
    "failure": null,
    "generatedOutputStatus": "unavailable",
    "actions": [],
    "links": {
      "self": "/openapi/v2/knowledge-bases/knowledge-base-11111111-1111-4111-8111-111111111111/source-files/source-file-11111111-1111-4111-8111-111111111111",
      "generatedContent": "/openapi/v2/knowledge-bases/knowledge-base-11111111-1111-4111-8111-111111111111/files/content?path=pages%2Fhandbook%2Fguide.md",
      "search": "/openapi/v2/knowledge-bases/knowledge-base-11111111-1111-4111-8111-111111111111/files/search?query=guide.md"
    },
    "createdAt": "2026-06-17T00:00:00.000Z"
  },
  "retry": {
    "kind": "document_processing",
    "scope": "source_file",
    "coalesced": false
  }
}

Error Codes

The table below lists every error response documented for this operation.

HTTP Status	Error Code	Explanation
401	UNAUTHORIZED	The Bearer API key is missing, malformed, unknown, revoked, or deleted.
404	NOT_FOUND	The requested resource was not found.
409	CONFLICT	The request conflicts with the resource's current state.
429	RATE_LIMITED	The request exceeded the configured rate limits.
500	INTERNAL_ERROR	The API encountered an internal error.
503	DATABASE_REPOSITORY_UNAVAILABLE	The data required by this operation is temporarily unavailable.

Next Steps

• Get uploaded file