devrev-Python-SDK 2.10.0__tar.gz → 2.10.2__tar.gz

{devrev_python_sdk-2.10.0 → devrev_python_sdk-2.10.2}/.github/workflows/api-check.yml

@@ -133,7 +133,7 @@ jobs:
 
       - name: Upload report
         if: steps.detect.outputs.has_changes == 'true'
-        uses: actions/upload-artifact@v6
+        uses: actions/upload-artifact@v7
         with:
           name: api-change-report
           path: api_change_report.md

{devrev_python_sdk-2.10.0 → devrev_python_sdk-2.10.2}/.github/workflows/ci.yml

@@ -52,7 +52,7 @@ jobs:
           fi
 
       - name: Upload coverage
-        uses: codecov/codecov-action@v3
+        uses: codecov/codecov-action@v5
         with:
           files: ./coverage.xml
           fail_ci_if_error: false

{devrev_python_sdk-2.10.0 → devrev_python_sdk-2.10.2}/.github/workflows/deploy.yml

@@ -42,13 +42,13 @@ jobs:
           echo "Deploying version: $VERSION"
 
       - name: Authenticate to Google Cloud (WIF)
-        uses: google-github-actions/auth@v2
+        uses: google-github-actions/auth@v3
         with:
           workload_identity_provider: ${{ secrets.WIF_PROVIDER }}
           service_account: ${{ secrets.WIF_SERVICE_ACCOUNT }}
 
       - name: Set up Cloud SDK
-        uses: google-github-actions/setup-gcloud@v2
+        uses: google-github-actions/setup-gcloud@v3
 
       - name: Configure Docker for Artifact Registry
         run: |

{devrev_python_sdk-2.10.0 → devrev_python_sdk-2.10.2}/.github/workflows/docs.yml

@@ -32,7 +32,7 @@ jobs:
           python-version: '3.12'
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v4
+        uses: astral-sh/setup-uv@v7
         with:
           version: "latest"
 

{devrev_python_sdk-2.10.0 → devrev_python_sdk-2.10.2}/.github/workflows/release.yml

@@ -32,7 +32,7 @@ jobs:
           python-version: '3.12'
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v4
+        uses: astral-sh/setup-uv@v7
 
       - name: Install dependencies
         run: uv sync --frozen --all-extras
@@ -77,7 +77,7 @@ jobs:
           python -c "import devrev; print(f'Installed: devrev')"
 
       - name: Upload artifacts
-        uses: actions/upload-artifact@v6
+        uses: actions/upload-artifact@v7
         with:
           name: dist
           path: dist/
@@ -93,7 +93,7 @@ jobs:
       url: https://pypi.org/project/py-devrev/
     steps:
       - name: Download artifacts
-        uses: actions/download-artifact@v7
+        uses: actions/download-artifact@v8
         with:
           name: dist
           path: dist/
@@ -115,7 +115,7 @@ jobs:
           fetch-depth: 0
 
       - name: Download artifacts
-        uses: actions/download-artifact@v7
+        uses: actions/download-artifact@v8
         with:
           name: dist
           path: dist/

{devrev_python_sdk-2.10.0 → devrev_python_sdk-2.10.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devrev-Python-SDK
-Version: 2.10.0
+Version: 2.10.2
 Summary: A modern, type-safe Python SDK for the DevRev API
 Project-URL: Homepage, https://github.com/mgmonteleone/py-dev-rev
 Project-URL: Documentation, https://github.com/mgmonteleone/py-dev-rev

{devrev_python_sdk-2.10.0 → devrev_python_sdk-2.10.2}/docs/changelog.md

@@ -7,6 +7,34 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.10.2] - 2026-03-11
+
+### Fixed
+
+- **Parts API missing parameters** (#158) — Added `owned_by`, `parent_part`, and `tags` parameters to `devrev_parts_create` MCP tool for full API compatibility.
+- **Article API missing properties** (#159) — Added missing `access_level`, `authored_by`, `extracted_content`, `owned_by`, `published_at`, `scope`, `shared_with`, `tags`, and `verified_by` fields to article models.
+
+### Maintenance
+
+- **Dependency updates** (#182) — Consolidated Dependabot updates (March 2026):
+  - Multiple dependency version updates via automated security scanning
+- **Documentation** — Updated `llms.txt` and `llms-mcp.txt` version references to 2.10.1.
+
+## [2.10.1] - 2026-03-10
+
+### Fixed
+
+- **MCP articles_list bug** (#170) — Fixed `'tuple' object has no attribute 'model_dump'` error in `devrev_articles_list` MCP tool by correctly accessing `response.articles` instead of calling `list()` on the Pydantic response model. Added `paginated_response()` helper for consistent pagination handling.
+- **CI formatting** (#175) — Resolved formatting check failures in `scripts/debug_articles.py`.
+
+### Maintenance
+
+- **Dependency updates** (#177) — Consolidated Dependabot updates:
+  - `actions/download-artifact` v7 → v8
+  - `codecov/codecov-action` v3 → v5
+  - `google-github-actions/auth` v2 → v3
+  - `authlib` 1.6.6 → 1.6.9 (security fix: removes "none" algorithm from default JWT instance)
+
 ## [2.10.0] - 2026-03-09
 
 ### Added

{devrev_python_sdk-2.10.0 → devrev_python_sdk-2.10.2}/llms-mcp.txt

@@ -5,7 +5,7 @@
 **Install**: `pip install devrev-python-sdk[mcp]`
 **Run**: `devrev-mcp-server`
 **Docs**: https://mgmonteleone.github.io/py-dev-rev/mcp/
-**Version**: 2.7.0
+**Version**: 2.10.1
 **Protocol**: MCP 2025-06-18
 
 ## Quick Setup

{devrev_python_sdk-2.10.0 → devrev_python_sdk-2.10.2}/llms.txt

@@ -10,7 +10,7 @@ Key information:
 - Both sync and async clients available (DevRevClient, AsyncDevRevClient)
 - Uses Pydantic v2 for all request/response models
 - MCP Server command: `devrev-mcp-server`
-- Version 2.7.0 (current)
+- Version 2.10.1 (current)
 
 ## SDK Quick Start
 

{devrev_python_sdk-2.10.0 → devrev_python_sdk-2.10.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "devrev-Python-SDK"
-version = "2.10.0"
+version = "2.10.2"
 description = "A modern, type-safe Python SDK for the DevRev API"
 readme = "README.md"
 requires-python = ">=3.11"

devrev_python_sdk-2.10.2/scripts/debug_articles.py

@@ -0,0 +1,200 @@
+#!/usr/bin/env python3
+"""Debug script for article content creation and inspection.
+
+Usage: python3 scripts/debug_articles.py
+Requires: DEVREV_API_TOKEN environment variable
+"""
+
+import json
+import os
+import sys
+
+# Add src to path
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src"))
+
+from devrev.client import DevRevClient  # noqa: E402
+from devrev.models.articles import (  # noqa: E402
+    ArticlesGetRequest,
+    ArticleStatus,
+)
+from devrev.models.artifacts import ArtifactGetRequest  # noqa: E402
+
+
+def inspect_article(client: DevRevClient, article_id: str) -> None:
+    """Inspect an article and its artifact content."""
+    print("\n" + "=" * 60)
+    print(f"INSPECTING ARTICLE: {article_id}")
+    print("=" * 60)
+
+    # Get article metadata
+    article = client.articles.get(ArticlesGetRequest(id=article_id))
+    print(f"\nTitle: {article.title}")
+    print(f"Status: {article.status}")
+    print(f"Description: {article.description}")
+    print(f"Resource: {json.dumps(article.resource, indent=2, default=str)}")
+
+    # Try to get content artifact
+    if article.resource:
+        # Check for artifacts array (how DevRev stores them)
+        artifacts = article.resource.get("artifacts", [])
+        if artifacts:
+            for art_info in artifacts:
+                art_id = art_info.get("id", "")
+                file_info = art_info.get("file", {})
+                print(f"\n--- Artifact: {art_id} ---")
+                print(f"  File name: {file_info.get('name')}")
+                print(f"  File type: {file_info.get('type')}")
+                print(f"  File size: {file_info.get('size')}")
+
+                # Get full artifact metadata
+                try:
+                    artifact = client.artifacts.get(ArtifactGetRequest(id=art_id))
+                    print(f"  Artifact metadata - file_name: {artifact.file_name}")
+                    print(f"  Artifact metadata - file_type: {artifact.file_type}")
+                    print(f"  Artifact metadata - version: {artifact.version}")
+                except Exception as e:
+                    print(f"  Error getting artifact metadata: {e}")
+
+                # Download content
+                try:
+                    content_bytes = client.artifacts.download(art_id)
+                    content = content_bytes.decode("utf-8")
+                    print(f"  Content length: {len(content)}")
+                    print("  Content preview (first 2000 chars):")
+                    print(f"  {content[:2000]}")
+                    if len(content) > 2000:
+                        print(f"  ... ({len(content) - 2000} more chars)")
+                except Exception as e:
+                    print(f"  Error downloading content: {e}")
+
+        # Check for content_artifact reference (how our SDK stores them)
+        content_artifact_id = article.resource.get("content_artifact")
+        if content_artifact_id:
+            print(f"\n--- Content Artifact (SDK style): {content_artifact_id} ---")
+            try:
+                content_bytes = client.artifacts.download(content_artifact_id)
+                content = content_bytes.decode("utf-8")
+                print(f"  Content length: {len(content)}")
+                print(f"  Content preview: {content[:1000]}")
+            except Exception as e:
+                print(f"  Error: {e}")
+
+
+def test_create_article(client: DevRevClient, owner_id: str) -> None:
+    """Test creating an article with HTML content."""
+    print("\n" + "=" * 60)
+    print("TEST: Creating article with HTML content")
+    print("=" * 60)
+
+    html_content = """<h1>Test Article from py-dev-rev SDK</h1>
+<p>This is a <strong>test article</strong> created via the py-dev-rev SDK.</p>
+<h2>Features</h2>
+<ul>
+<li>Rich <em>formatted</em> text</li>
+<li>Lists and headings</li>
+<li>Code: <code>print("hello")</code></li>
+</ul>
+<p>Created at: 2026-03-07 for debugging purposes.</p>"""
+
+    try:
+        article = client.articles.create_with_content(
+            title="SDK Test - Rich Content Article",
+            content=html_content,
+            owned_by=[owner_id],
+            description="Test article created by py-dev-rev SDK debug script",
+            status=ArticleStatus.DRAFT,
+            content_format="text/html",
+        )
+        print(f"✅ Article created: {article.id} (display: {article.display_id})")
+        print(f"  Title: {article.title}")
+        print(f"  Resource: {json.dumps(article.resource, indent=2, default=str)}")
+
+        # Now test get_with_content on the new article
+        test_get_with_content(client, article.id)
+
+        # Now test update_content
+        test_update_content(client, article.id)
+
+    except Exception as e:
+        print(f"❌ Failed to create article: {e}")
+        import traceback
+
+        traceback.print_exc()
+
+
+def test_get_with_content(client: DevRevClient, article_id: str) -> None:
+    """Test the get_with_content method."""
+    print("\n" + "=" * 60)
+    print(f"TEST: get_with_content for {article_id}")
+    print("=" * 60)
+
+    try:
+        result = client.articles.get_with_content(article_id)
+        print("✅ get_with_content succeeded!")
+        print(f"  Title: {result.article.title}")
+        print(f"  Content format: {result.content_format}")
+        print(f"  Content version: {result.content_version}")
+        print(f"  Content length: {len(result.content)}")
+        print(f"  Content preview: {result.content[:500]}")
+    except Exception as e:
+        print(f"❌ get_with_content failed: {e}")
+        import traceback
+
+        traceback.print_exc()
+
+
+def test_update_content(client: DevRevClient, article_id: str) -> None:
+    """Test updating article content."""
+    print("\n" + "=" * 60)
+    print(f"TEST: update_content for {article_id}")
+    print("=" * 60)
+
+    updated_html = """<h1>Updated Article</h1>
+<p>This content was <strong>updated</strong> by the py-dev-rev SDK.</p>
+<p>Updated at: 2026-03-07</p>"""
+
+    try:
+        article = client.articles.update_content(article_id, updated_html)
+        print("✅ update_content succeeded!")
+        print(f"  Title: {article.title}")
+        print(f"  Resource: {json.dumps(article.resource, indent=2, default=str)}")
+
+        # Verify by re-reading
+        result = client.articles.get_with_content(article_id)
+        print(f"  Verified content length: {len(result.content)}")
+        print(f"  Verified content: {result.content[:300]}")
+    except Exception as e:
+        print(f"❌ update_content failed: {e}")
+        import traceback
+
+        traceback.print_exc()
+
+
+def main() -> None:
+    """Run article diagnostics."""
+    token = os.environ.get("DEVREV_API_TOKEN")
+    if not token:
+        print("ERROR: DEVREV_API_TOKEN environment variable not set")
+        sys.exit(1)
+
+    client = DevRevClient()
+
+    # 1. Inspect the known working article ART-2817
+    art_2817_id = "don:core:dvrv-us-1:devo/11Ca9baGrM:article/2817"
+    inspect_article(client, art_2817_id)
+
+    # 2. Test get_with_content on ART-2817
+    test_get_with_content(client, art_2817_id)
+
+    # 3. Get owner ID for creating test articles
+    owner_id = "don:identity:dvrv-us-1:devo/11Ca9baGrM:devu/4"  # MGM
+
+    # 4. Try creating a new article with HTML content
+    test_create_article(client, owner_id)
+
+    # 5. Test get_with_content on the newly created article
+    # (test_create_article already inspects it, but let's also test the unified method)
+
+
+if __name__ == "__main__":
+    main()

{devrev_python_sdk-2.10.0 → devrev_python_sdk-2.10.2}/src/devrev/models/articles.py

@@ -94,6 +94,29 @@ class ArticleParentSummary(DevRevResponseModel):
     display_id: str | None = Field(default=None, description="Display ID")
 
 
+class ArtifactSummary(DevRevResponseModel):
+    """Summary of an artifact (used for extracted_content)."""
+
+    id: str = Field(..., description="Artifact DON ID")
+    display_id: str | None = Field(default=None, description="Display ID")
+    file: dict[str, Any] | None = Field(default=None, description="File metadata")
+
+
+class SyncMetadata(DevRevResponseModel):
+    """Sync information for records synced into/from DevRev."""
+
+    external_reference: str | None = Field(default=None, description="External record URL")
+    origin_system: str | None = Field(
+        default=None, description="Where the record was first created"
+    )
+    last_sync_in: dict[str, Any] | None = Field(
+        default=None, description="Information about the sync to DevRev"
+    )
+    last_sync_out: dict[str, Any] | None = Field(
+        default=None, description="Information about the sync from DevRev"
+    )
+
+
 class Article(DevRevResponseModel):
     """DevRev Article model.
 
@@ -106,13 +129,29 @@ class Article(DevRevResponseModel):
     title: str = Field(..., description="Article title")
     description: str | None = Field(default=None, description="Article description/body")
     status: ArticleStatus | None = Field(default=None, description="Article status")
+    access_level: ArticleAccessLevel | None = Field(
+        default=None, description="Access level (external, internal, private, public, restricted)"
+    )
+    aliases: list[str] | None = Field(default=None, description="Aliases of the article")
     article_type: str | None = Field(default=None, description="Article type (article, page, etc.)")
     authored_by: list[UserSummary] | None = Field(
         default=None, description="Authors of the article (API returns array, not single object)"
     )
+    brand: dict[str, Any] | None = Field(
+        default=None, description="Brand associated with the article"
+    )
     owned_by: list[UserSummary] | None = Field(default=None, description="Owners of the article")
     created_date: datetime | None = Field(default=None, description="Creation date")
     modified_date: datetime | None = Field(default=None, description="Last modified")
+    extracted_content: list[ArtifactSummary] | None = Field(
+        default=None, description="Extracted content artifacts"
+    )
+    num_downvotes: int | None = Field(
+        default=None, description="Number of downvotes on the article"
+    )
+    num_upvotes: int | None = Field(default=None, description="Number of upvotes on the article")
+    published_at: datetime | None = Field(default=None, description="Published date of the article")
+    rank: str | None = Field(default=None, description="Rank of the article")
     resource: dict[str, Any] | None = Field(
         default=None, description="Resource configuration including artifact references"
     )
@@ -122,6 +161,9 @@ class Article(DevRevResponseModel):
     scope: ArticleScope | None = Field(
         default=None, description="Visibility scope (internal/external)"
     )
+    sync_metadata: SyncMetadata | None = Field(
+        default=None, description="Sync information for records synced into/from DevRev"
+    )
     tags: list[ArticleTagWithValue] | None = Field(
         default=None, description="Tags applied to the article"
     )
@@ -129,6 +171,7 @@ class Article(DevRevResponseModel):
         default=None, description="Parent directory/collection"
     )
     language: str | None = Field(default=None, description="Language code (e.g., 'en')")
+    url: str | None = Field(default=None, description="URL of the external article")
 
 
 class ArticleSummary(DevRevResponseModel):
@@ -168,6 +211,28 @@ class ArticlesCreateRequest(DevRevBaseModel):
     title: str = Field(..., description="Article title")
     description: str | None = Field(default=None, description="Article description/body")
     status: ArticleStatus | None = Field(default=None, description="Article status")
+    access_level: ArticleAccessLevel | None = Field(
+        default=None, description="Access level (external, internal, private, public, restricted)"
+    )
+    aliases: list[str] | None = Field(default=None, description="Aliases of the article (max 5)")
+    authored_by: list[str] | None = Field(
+        default=None, description="List of user IDs who author the article"
+    )
+    brand: str | None = Field(default=None, description="Brand ID associated with the article")
+    content_format: ArticleContentFormat | None = Field(
+        default=None, description="Content format (drdfv2, rt)"
+    )
+    custom_fields: dict[str, Any] | None = Field(
+        default=None, description="Application-defined custom fields"
+    )
+    custom_schema_spec: CustomSchemaSpec | None = Field(
+        default=None, description="Custom schema spec"
+    )
+    extracted_content: list[str] | None = Field(
+        default=None, description="IDs of extracted content artifacts"
+    )
+    language: str | None = Field(default=None, description="Language of the article")
+    notify: bool | None = Field(default=None, description="Whether to notify users when published")
     owned_by: list[str] = Field(..., description="List of dev user IDs who own the article")
     resource: dict[str, Any] = Field(
         default_factory=dict, description="Resource configuration for the article"
@@ -176,6 +241,9 @@ class ArticlesCreateRequest(DevRevBaseModel):
         default=None, description="List of part IDs this article applies to"
     )
     scope: int | None = Field(default=None, description="Visibility scope: 1=internal, 2=external")
+    shared_with: list[SetSharedWithMembership] | None = Field(
+        default=None, description="Users/groups to share the article with"
+    )
     tags: list[SetTagWithValue] | None = Field(
         default=None, description="Tags to apply (list of {'id': 'tag_id', 'value': ...})"
     )
@@ -183,6 +251,8 @@ class ArticlesCreateRequest(DevRevBaseModel):
     article_type: str | None = Field(
         default=None, description="Article type: 'article' (default), 'page', 'content_block'"
     )
+    published_at: datetime | None = Field(default=None, description="Published date of the article")
+    release_notes: str | None = Field(default=None, description="Release notes for the article")
 
 
 class ArticlesGetRequest(DevRevBaseModel):

{devrev_python_sdk-2.10.0 → devrev_python_sdk-2.10.2}/src/devrev/models/parts.py

@@ -53,11 +53,26 @@ class PartSummary(DevRevResponseModel):
 
 
 class PartsCreateRequest(DevRevBaseModel):
-    """Request to create a part."""
+    """Request to create a part.
+
+    For non-product parts (capability, feature, enhancement), the parent_part
+    parameter is required to specify the parent part in the hierarchy.
+    """
 
     name: str = Field(..., description="Part name")
     type: PartType = Field(..., description="Part type")
     description: str | None = Field(default=None, description="Description")
+    owned_by: list[str] | None = Field(
+        default=None,
+        description="List of owner user IDs (e.g., ['DEVU-4'] or full DON IDs)",
+    )
+    parent_part: list[str] | None = Field(
+        default=None,
+        description="Parent part ID (required for capability/feature/enhancement). "
+        "Array with at most 1 element.",
+        max_length=1,
+    )
+    tags: list[str] | None = Field(default=None, description="List of tag IDs")
 
 
 class PartsGetRequest(DevRevBaseModel):

{devrev_python_sdk-2.10.0 → devrev_python_sdk-2.10.2}/src/devrev/services/articles.py

@@ -196,12 +196,15 @@ class ArticlesService(BaseService):
         owned_by: builtins.list[str],
         description: str | None = None,
         status: ArticleStatus | None = None,
+        access_level: ArticleAccessLevel | None = None,
         content_format: str = "text/plain",
         applies_to_parts: builtins.list[str] | None = None,
         scope: int | None = None,
         tags: builtins.list[SetTagWithValue] | None = None,
         parent: str | None = None,
         article_type: str | None = None,
+        language: str | None = None,
+        authored_by: builtins.list[str] | None = None,
     ) -> Article:
         """Create an article with content in a single operation.
 
@@ -218,12 +221,15 @@ class ArticlesService(BaseService):
             owned_by: List of dev user IDs who own the article
             description: Optional short metadata description (NOT the article content)
             status: Optional article status (draft, published, archived)
+            access_level: Optional access level (external, internal, private, public, restricted)
             content_format: Content MIME type (default: text/plain)
             applies_to_parts: Optional list of part IDs to associate with
             scope: Optional visibility scope (1=internal, 2=external)
             tags: Optional tags (list of SetTagWithValue)
             parent: Optional parent directory/collection DON ID
             article_type: Optional article type ('article', 'page', 'content_block')
+            language: Optional language code (e.g., 'en')
+            authored_by: Optional list of user IDs who author the article
 
         Returns:
             Created article
@@ -239,6 +245,7 @@ class ArticlesService(BaseService):
             ...     content_format="text/html",
             ...     applies_to_parts=["don:core:...:feature/30"],
             ...     scope=2,  # external
+            ...     access_level=ArticleAccessLevel.EXTERNAL,
             ... )
         """
         if not self._parent_client:
@@ -275,6 +282,7 @@ class ArticlesService(BaseService):
                 title=title,
                 description=description,
                 status=status,
+                access_level=access_level,
                 owned_by=owned_by,
                 resource={"content_artifact": artifact_id},
                 applies_to_parts=applies_to_parts,
@@ -282,6 +290,8 @@ class ArticlesService(BaseService):
                 tags=tags,
                 parent=parent,
                 article_type=article_type,
+                language=language,
+                authored_by=authored_by,
             )
             return self.create(article_req)
 
@@ -443,6 +453,7 @@ class ArticlesService(BaseService):
         applies_to_parts: builtins.list[str] | None = None,
         access_level: ArticleAccessLevel | None = None,
         tags: builtins.list[SetTagWithValue] | None = None,
+        language: str | None = None,
     ) -> Article:
         """Update article metadata and/or content.
 
@@ -460,6 +471,7 @@ class ArticlesService(BaseService):
             applies_to_parts: Optional list of part IDs to associate with
             access_level: Optional access level (internal, external, private, public)
             tags: Optional list of tags to apply (list of SetTagWithValue objects)
+            language: Optional language code (e.g., 'en')
 
         Returns:
             Updated article
@@ -528,6 +540,7 @@ class ArticlesService(BaseService):
             or applies_to_parts is not None
             or access_level is not None
             or tags is not None
+            or language is not None
         )
         if has_metadata:
             update_req = ArticlesUpdateRequest(
@@ -538,6 +551,7 @@ class ArticlesService(BaseService):
                 applies_to_parts=applies_to_parts_req,
                 access_level=access_level,
                 tags=tags_req,
+                language=language,
             )
             return self.update(update_req)
 
@@ -642,12 +656,15 @@ class AsyncArticlesService(AsyncBaseService):
         owned_by: builtins.list[str],
         description: str | None = None,
         status: ArticleStatus | None = None,
+        access_level: ArticleAccessLevel | None = None,
         content_format: str = "text/plain",
         applies_to_parts: builtins.list[str] | None = None,
         scope: int | None = None,
         tags: builtins.list[SetTagWithValue] | None = None,
         parent: str | None = None,
         article_type: str | None = None,
+        language: str | None = None,
+        authored_by: builtins.list[str] | None = None,
     ) -> Article:
         """Create an article with content in a single operation (async).
 
@@ -664,12 +681,15 @@ class AsyncArticlesService(AsyncBaseService):
             owned_by: List of dev user IDs who own the article
             description: Optional short metadata description (NOT the article content)
             status: Optional article status (draft, published, archived)
+            access_level: Optional access level (external, internal, private, public, restricted)
             content_format: Content MIME type (default: text/plain)
             applies_to_parts: Optional list of part IDs to associate with
             scope: Optional visibility scope (1=internal, 2=external)
             tags: Optional tags (list of SetTagWithValue)
             parent: Optional parent directory/collection DON ID
             article_type: Optional article type ('article', 'page', 'content_block')
+            language: Optional language code (e.g., 'en')
+            authored_by: Optional list of user IDs who author the article
 
         Returns:
             Created article
@@ -710,6 +730,7 @@ class AsyncArticlesService(AsyncBaseService):
                 title=title,
                 description=description,
                 status=status,
+                access_level=access_level,
                 owned_by=owned_by,
                 resource={"content_artifact": artifact_id},
                 applies_to_parts=applies_to_parts,
@@ -717,6 +738,8 @@ class AsyncArticlesService(AsyncBaseService):
                 tags=tags,
                 parent=parent,
                 article_type=article_type,
+                language=language,
+                authored_by=authored_by,
             )
             return await self.create(article_req)
 
@@ -867,6 +890,7 @@ class AsyncArticlesService(AsyncBaseService):
         applies_to_parts: builtins.list[str] | None = None,
         access_level: ArticleAccessLevel | None = None,
         tags: builtins.list[SetTagWithValue] | None = None,
+        language: str | None = None,
     ) -> Article:
         """Update article metadata and/or content (async).
 
@@ -884,6 +908,7 @@ class AsyncArticlesService(AsyncBaseService):
             applies_to_parts: Optional list of part IDs to associate with
             access_level: Optional access level (internal, external, private, public)
             tags: Optional list of tags to apply (list of SetTagWithValue objects)
+            language: Optional language code (e.g., 'en')
 
         Returns:
             Updated article
@@ -919,6 +944,7 @@ class AsyncArticlesService(AsyncBaseService):
             or applies_to_parts is not None
             or access_level is not None
             or tags is not None
+            or language is not None
         )
         if has_metadata:
             update_req = ArticlesUpdateRequest(
@@ -929,6 +955,7 @@ class AsyncArticlesService(AsyncBaseService):
                 applies_to_parts=applies_to_parts_req,
                 access_level=access_level,
                 tags=tags_req,
+                language=language,
             )
             return await self.update(update_req)