knowledge.translate

A copy of a document in another language.

Reference

POST/api/v1/knowledge-base/documents/{document_uuid}/translate

Auth

API key in X-API-Key

Content

application/json

Returns

202 · DocumentResponseSchema

A translated copy, as a document of its own in the same scope. Returned pending; the list already polls pending rows to completion. The ingestion quota applies as it does to an upload -- this is one.

Arguments

Argument	In	Type	Required	Description
document_uuid	path	string	required
target_language_code	body	string	default "en-IN"

Example request

curl -X POST "https://api.decibyl.ai/api/v1/knowledge-base/documents/<document_uuid>/translate" \
  -H "X-API-Key: dcb_your_key" \
  -H "Content-Type: application/json" \
  -d '{"target_language_code":"en-IN"}'

Response

{
  "id": 1,
  "document_uuid": "string",
  "filename": "string",
  "file_size_bytes": 1,
  "file_hash": "string",
  "mime_type": "string",
  "processing_status": "string",
  "processing_error": "string",
  "needs_reingest": false,
  "total_chunks": 1,
  "retrieval_mode": "chunked",
  "custom_metadata": {},
  "docling_metadata": {},
  "source_url": "string",
  "scope": "library",
  "folder_id": 1,
  "workflow_id": 1,
  "file_folder_id": 1,
  "created_at": "2026-09-14T09:30:00Z",
  "updated_at": "2026-09-14T09:30:00Z",
  "organization_id": 1,
  "created_by": 1,
  "is_active": true,
  "version": 1,
  "versions": [
    {
      "version": 1,
      "uploaded_at": "string",
      "uploaded_by": 1,
      "file_size_bytes": 1,
      "current": false
    }
  ],
  "state": "ready",
  "state_detail": "string"
}

Errors

Status	When
404	Not found
422	Validation Error