docsTranslation APICapabilities

    🧩 Get Capabilities

    This API returns the translation features available to the account that owns the API key: which features are enabled, which document modes and file types each one applies to, and which features cannot be combined.

    📋 Basic Information

    • Method: GET
    • Path: https://api.bluente.com/api/20250924/blu_translate/capabilities
    • Authentication: Required — Authorization: Bearer $BLUENTE_API_KEY

    📝 Request Parameters

    • Query Parameters: None
    • Request Body: None

    💡 Example

    curl -X GET "https://api.bluente.com/api/20250924/blu_translate/capabilities" \
     -H "Authorization: Bearer $BLUENTE_API_KEY" \
     -H "Accept: application/json"

    or

    fetch("https://api.bluente.com/api/20250924/blu_translate/capabilities", {
  method: "GET",
  headers: {
    "Authorization": "Bearer $BLUENTE_API_KEY",
    "Accept": "application/json"
  }
});

    ✅ Success Response Example

    The values below are examples. The features and rules returned depend on the account.

    {
  "message": "success",
  "code": 0,
  "data": {
    "policy_version": "3f9c2a…",
    "features": [
      {
        "feature_key": "translate_bilingual",
        "display_name": "Bilingual",
        "enabled": true,
        "applicable_document_modes": ["STANDARD"],
        "applicable_file_types": ["pdf", "docx"],
        "grantable": true,
        "active": true,
        "sort_order": 10,
        "conflicts_with": []
      }
    ]
  }
}

    📊 Response Fields

    FieldTypeDescription
    data.policy_versionstringVersion of the feature rules. It changes when the rules change
    data.featuresarrayOne entry per translation feature
    └─ feature_keystringFeature ID, e.g. standard, scanned_text_only, scanned_overlay, image_translation, custom_glossary, table_layout_enhancement, translate_bilingual, translate_images_within_file, custom_font
    └─ display_namestringHuman-readable name
    └─ descriptionstringDescription (may be omitted)
    └─ enabledbooltrue if this account can use the feature
    └─ applicable_document_modesarrayDocument modes the feature applies to (STANDARD, SCANNED_TEXT_ONLY, SCANNED_OVERLAY, IMAGE_TRANSLATION)
    └─ applicable_file_typesarrayFile types the feature applies to
    └─ conflicts_witharrayFeatures that cannot be selected together with this one
    └─ conflicts_with[].feature_keystringThe conflicting feature
    └─ conflicts_with[].reasonstringWhy they conflict
    └─ active, grantable, sort_order—Feature status and display order

    📌 Notes

    • Use this API to show or hide translation options in your own UI.
    • Selecting a feature that is not enabled for the account makes Translate File return code: 41. Selecting one that doesn’t apply to the file, or two that conflict, returns code: 40. See Error Codes.
    • To check one concrete request against these rules, use Validate Options.
    • InDesign (IDML) has its own restrictions on top of these rules. See InDesign (IDML).
    User creditUpload file