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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devrev-Python-SDK
-Version: 2.9.0
+Version: 2.10.0
 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
@@ -545,6 +545,16 @@ client.articles.update_with_content(
     applies_to_parts=["don:core:dvrv-us-1:devo/1:part/123", "don:core:dvrv-us-1:devo/1:part/456"],
 )
 
+# Update access level and tags
+from devrev.models.articles import ArticleAccessLevel
+from devrev.models.base import SetTagWithValue
+
+client.articles.update_with_content(
+    id=article.id,
+    access_level=ArticleAccessLevel.INTERNAL,  # internal, external, private, public
+    tags=[SetTagWithValue(id="don:core:dvrv-us-1:devo/1:tag/123")],
+)
+
 # List published articles (metadata only)
 published = client.articles.list(limit=20)
 for article in published:

{devrev_python_sdk-2.9.0 → devrev_python_sdk-2.10.0}/README.md

@@ -470,6 +470,16 @@ client.articles.update_with_content(
     applies_to_parts=["don:core:dvrv-us-1:devo/1:part/123", "don:core:dvrv-us-1:devo/1:part/456"],
 )
 
+# Update access level and tags
+from devrev.models.articles import ArticleAccessLevel
+from devrev.models.base import SetTagWithValue
+
+client.articles.update_with_content(
+    id=article.id,
+    access_level=ArticleAccessLevel.INTERNAL,  # internal, external, private, public
+    tags=[SetTagWithValue(id="don:core:dvrv-us-1:devo/1:tag/123")],
+)
+
 # List published articles (metadata only)
 published = client.articles.list(limit=20)
 for article in published:

{devrev_python_sdk-2.9.0 → devrev_python_sdk-2.10.0}/docs/api/services/articles.md

@@ -94,6 +94,8 @@ article = client.articles.create_with_content(
     status=ArticleStatus.PUBLISHED,  # Optional: draft, published, archived
     content_format="text/html",  # Optional: default is text/html
     applies_to_parts=["don:core:dvrv-us-1:devo/1:part/123"],  # Optional: associate with parts
+    scope=1,  # Optional: 1=internal, 2=external (API default is external)
+    tags=[SetTagWithValue(id="don:core:dvrv-us-1:devo/1:tag/123")],  # Optional: apply tags
 )
 print(f"Created article with content: {article.id}")
 ```
@@ -188,6 +190,16 @@ updated_article = client.articles.update_with_content(
     id="don:core:dvrv-us-1:devo/1:article/123",
     applies_to_parts=["don:core:dvrv-us-1:devo/1:part/123", "don:core:dvrv-us-1:devo/1:part/456"],
 )
+
+# Update access level and tags
+from devrev.models.articles import ArticleAccessLevel
+from devrev.models.base import SetTagWithValue
+
+updated_article = client.articles.update_with_content(
+    id="don:core:dvrv-us-1:devo/1:article/123",
+    access_level=ArticleAccessLevel.INTERNAL,  # Change to internal visibility
+    tags=[SetTagWithValue(id="don:core:dvrv-us-1:devo/1:tag/123")],  # Apply tags
+)
 ```
 
 ### Async Usage

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

@@ -7,6 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.10.0] - 2026-03-09
+
+### Added
+
+- **Article Scope and Tags** (#173) — Added visibility and tagging parameters to MCP article tools:
+  - `devrev_articles_create`: Added `scope` (1=internal, 2=external) and `tags` (list of tag IDs) parameters
+  - `devrev_articles_update`: Added `access_level` (internal, external, private, public) and `tags` parameters
+  - SDK `update_with_content`: Added `access_level` and `tags` parameters for both sync and async methods
+
 ## [2.9.0] - 2026-03-09
 
 ### Added

{devrev_python_sdk-2.9.0 → devrev_python_sdk-2.10.0}/docs/mcp/tools-reference.md

@@ -57,6 +57,8 @@ Tools are the primary way AI assistants interact with DevRev. Each tool maps to
 - **Optional Content Loading**: Use `include_content=true` in `get` to fetch article body
 - **Clear Parameters**: `content` for article body, `description` for metadata summary
 - **Part Association**: Use `applies_to_parts` to natively associate articles with products, capabilities, features, or enhancements
+- **Visibility Control**: Use `scope` (1=internal, 2=external) on create or `access_level` (internal, external, private, public) on update
+- **Tagging**: Apply tags using the `tags` parameter (list of tag IDs)
 
 ### Conversations
 

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

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

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

@@ -9,6 +9,7 @@ from collections.abc import Sequence
 from devrev.exceptions import DevRevError
 from devrev.models.articles import (
     Article,
+    ArticleAccessLevel,
     ArticlesCountRequest,
     ArticlesCountResponse,
     ArticlesCreateRequest,
@@ -22,6 +23,7 @@ from devrev.models.articles import (
     ArticleStatus,
     ArticlesUpdateRequest,
     ArticlesUpdateRequestAppliesToParts,
+    ArticlesUpdateRequestTags,
     ArticlesUpdateResponse,
     ArticleType,
     ArticleWithContent,
@@ -439,6 +441,8 @@ class ArticlesService(BaseService):
         description: str | None = None,
         status: ArticleStatus | None = None,
         applies_to_parts: builtins.list[str] | None = None,
+        access_level: ArticleAccessLevel | None = None,
+        tags: builtins.list[SetTagWithValue] | None = None,
     ) -> Article:
         """Update article metadata and/or content.
 
@@ -454,6 +458,8 @@ class ArticlesService(BaseService):
             description: Optional new metadata description
             status: Optional new status
             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)
 
         Returns:
             Updated article
@@ -487,6 +493,12 @@ class ArticlesService(BaseService):
             ...     "ART-123",
             ...     applies_to_parts=["don:core:...:capability/6"]
             ... )
+            >>>
+            >>> # Update access level to internal
+            >>> article = client.articles.update_with_content(
+            ...     "ART-123",
+            ...     access_level=ArticleAccessLevel.INTERNAL
+            ... )
         """
         if not self._parent_client:
             raise DevRevError(
@@ -503,12 +515,19 @@ class ArticlesService(BaseService):
         if applies_to_parts is not None:
             applies_to_parts_req = ArticlesUpdateRequestAppliesToParts(set=applies_to_parts)
 
+        # Build tags wrapper if provided
+        tags_req = None
+        if tags is not None:
+            tags_req = ArticlesUpdateRequestTags(set=tags)
+
         # Update metadata if any metadata fields provided
         has_metadata = (
             title is not None
             or description is not None
             or status is not None
             or applies_to_parts is not None
+            or access_level is not None
+            or tags is not None
         )
         if has_metadata:
             update_req = ArticlesUpdateRequest(
@@ -517,6 +536,8 @@ class ArticlesService(BaseService):
                 description=description,
                 status=status,
                 applies_to_parts=applies_to_parts_req,
+                access_level=access_level,
+                tags=tags_req,
             )
             return self.update(update_req)
 
@@ -844,6 +865,8 @@ class AsyncArticlesService(AsyncBaseService):
         description: str | None = None,
         status: ArticleStatus | None = None,
         applies_to_parts: builtins.list[str] | None = None,
+        access_level: ArticleAccessLevel | None = None,
+        tags: builtins.list[SetTagWithValue] | None = None,
     ) -> Article:
         """Update article metadata and/or content (async).
 
@@ -859,6 +882,8 @@ class AsyncArticlesService(AsyncBaseService):
             description: Optional new metadata description
             status: Optional new status
             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)
 
         Returns:
             Updated article
@@ -881,12 +906,19 @@ class AsyncArticlesService(AsyncBaseService):
         if applies_to_parts is not None:
             applies_to_parts_req = ArticlesUpdateRequestAppliesToParts(set=applies_to_parts)
 
+        # Build tags wrapper if provided
+        tags_req = None
+        if tags is not None:
+            tags_req = ArticlesUpdateRequestTags(set=tags)
+
         # Update metadata if any metadata fields provided
         has_metadata = (
             title is not None
             or description is not None
             or status is not None
             or applies_to_parts is not None
+            or access_level is not None
+            or tags is not None
         )
         if has_metadata:
             update_req = ArticlesUpdateRequest(
@@ -895,6 +927,8 @@ class AsyncArticlesService(AsyncBaseService):
                 description=description,
                 status=status,
                 applies_to_parts=applies_to_parts_req,
+                access_level=access_level,
+                tags=tags_req,
             )
             return await self.update(update_req)
 

{devrev_python_sdk-2.9.0 → devrev_python_sdk-2.10.0}/src/devrev_mcp/tools/articles.py

@@ -12,11 +12,13 @@ from mcp.server.fastmcp import Context
 
 from devrev.exceptions import DevRevError
 from devrev.models.articles import (
+    ArticleAccessLevel,
     ArticlesDeleteRequest,
     ArticlesGetRequest,
     ArticlesListRequest,
     ArticleStatus,
 )
+from devrev.models.base import SetTagWithValue
 from devrev_mcp.server import _config, mcp
 from devrev_mcp.utils.errors import format_devrev_error
 from devrev_mcp.utils.formatting import serialize_model, serialize_models
@@ -103,6 +105,8 @@ if _config.enable_destructive_tools:
         status: str | None = None,
         content_format: str = "text/html",
         applies_to_parts: list[str] | None = None,
+        scope: int | None = None,
+        tags: list[str] | None = None,
     ) -> dict[str, Any]:
         """Create a new article with content.
 
@@ -116,6 +120,8 @@ if _config.enable_destructive_tools:
             content_format: Content MIME type (default: text/html).
             applies_to_parts: Optional list of part IDs (products, capabilities,
                 features, enhancements) to associate the article with.
+            scope: Optional visibility scope (1=internal, 2=external).
+            tags: Optional list of tag IDs to apply to the article.
 
         Returns:
             Dictionary containing the created article details.
@@ -135,6 +141,9 @@ if _config.enable_destructive_tools:
                         f"Valid statuses: {', '.join(s.name for s in ArticleStatus)}"
                     ) from e
 
+            # Convert tag IDs to SetTagWithValue objects
+            tags_list = [SetTagWithValue(id=tag_id) for tag_id in tags] if tags is not None else None
+
             article = await app.get_client().articles.create_with_content(
                 title=title,
                 content=content,
@@ -143,6 +152,8 @@ if _config.enable_destructive_tools:
                 status=article_status,
                 content_format=content_format,
                 applies_to_parts=applies_to_parts,
+                scope=scope,
+                tags=tags_list,
             )
             return serialize_model(article)
         except DevRevError as e:
@@ -157,6 +168,8 @@ if _config.enable_destructive_tools:
         description: str | None = None,
         status: str | None = None,
         applies_to_parts: list[str] | None = None,
+        access_level: str | None = None,
+        tags: list[str] | None = None,
     ) -> dict[str, Any]:
         """Update an existing article in DevRev.
 
@@ -170,6 +183,11 @@ if _config.enable_destructive_tools:
             applies_to_parts: Optional list of part IDs (products, capabilities,
                 features, enhancements) to associate the article with.
                 Pass an empty list to remove all associations.
+            access_level: Optional access level (internal, external, private, public).
+                Note: For updates, use ``access_level`` (string enum). For creation,
+                use the ``scope`` parameter (integer: 1=internal, 2=external).
+            tags: Optional list of tag IDs to apply to the article.
+                Pass an empty list to remove all tags.
 
         Returns:
             Dictionary containing the updated article details.
@@ -189,6 +207,20 @@ if _config.enable_destructive_tools:
                         f"Valid statuses: {', '.join(s.name for s in ArticleStatus)}"
                     ) from e
 
+            # Convert access_level string to ArticleAccessLevel enum
+            article_access_level = None
+            if access_level:
+                try:
+                    article_access_level = ArticleAccessLevel[access_level.upper()]
+                except KeyError as e:
+                    raise RuntimeError(
+                        f"Invalid access level: {e.args[0]}. "
+                        f"Valid levels: {', '.join(a.name for a in ArticleAccessLevel)}"
+                    ) from e
+
+            # Convert tag IDs to SetTagWithValue objects
+            tags_list = [SetTagWithValue(id=tag_id) for tag_id in tags] if tags is not None else None
+
             article = await app.get_client().articles.update_with_content(
                 id=id,
                 title=title,
@@ -196,6 +228,8 @@ if _config.enable_destructive_tools:
                 description=description,
                 status=article_status,
                 applies_to_parts=applies_to_parts,
+                access_level=article_access_level,
+                tags=tags_list,
             )
             return serialize_model(article)
         except DevRevError as e:

{devrev_python_sdk-2.9.0 → devrev_python_sdk-2.10.0}/tests/unit/mcp/test_tools_articles.py

@@ -182,6 +182,53 @@ class TestArticlesCreateTool:
             "don:core:dvrv-us-1:devo/1:capability/2",
         ]
 
+    @pytest.mark.asyncio
+    async def test_create_with_scope(self, mock_ctx, mock_client):
+        """Test creating an article with scope (internal)."""
+        mock_article = _make_mock_article(
+            title="Internal Article",
+            description="Internal content",
+        )
+        mock_client.articles.create_with_content.return_value = mock_article
+
+        result = await devrev_articles_create(
+            mock_ctx,
+            title="Internal Article",
+            content="Internal content",
+            owned_by=["don:identity:dvrv-us-1:devo/test:devu/1"],
+            scope=1,  # 1 = internal
+        )
+
+        assert result["title"] == "Internal Article"
+        # Verify scope was passed to SDK
+        call_args = mock_client.articles.create_with_content.call_args
+        assert call_args[1]["scope"] == 1
+
+    @pytest.mark.asyncio
+    async def test_create_with_tags(self, mock_ctx, mock_client):
+        """Test creating an article with tags."""
+        mock_article = _make_mock_article(
+            title="Tagged Article",
+            description="Content with tags",
+        )
+        mock_client.articles.create_with_content.return_value = mock_article
+
+        result = await devrev_articles_create(
+            mock_ctx,
+            title="Tagged Article",
+            content="Content with tags",
+            owned_by=["don:identity:dvrv-us-1:devo/test:devu/1"],
+            tags=["don:core:dvrv-us-1:devo/1:tag/1", "don:core:dvrv-us-1:devo/1:tag/2"],
+        )
+
+        assert result["title"] == "Tagged Article"
+        # Verify tags were converted to SetTagWithValue and passed to SDK
+        call_args = mock_client.articles.create_with_content.call_args
+        tags_arg = call_args[1]["tags"]
+        assert len(tags_arg) == 2
+        assert tags_arg[0].id == "don:core:dvrv-us-1:devo/1:tag/1"
+        assert tags_arg[1].id == "don:core:dvrv-us-1:devo/1:tag/2"
+
 
 class TestArticlesUpdateTool:
     """Tests for devrev_articles_update tool."""
@@ -236,6 +283,109 @@ class TestArticlesUpdateTool:
         call_args = mock_client.articles.update_with_content.call_args
         assert call_args[1]["applies_to_parts"] == ["don:core:dvrv-us-1:devo/1:feature/3"]
 
+    @pytest.mark.asyncio
+    async def test_update_with_access_level(self, mock_ctx, mock_client):
+        """Test updating an article with access_level."""
+        from devrev.models.articles import ArticleAccessLevel
+
+        mock_article = _make_mock_article(
+            id="article-1",
+            title="Internal Article",
+            status="published",
+        )
+        mock_client.articles.update_with_content.return_value = mock_article
+
+        result = await devrev_articles_update(
+            mock_ctx,
+            id="article-1",
+            access_level="internal",
+        )
+
+        assert result["title"] == "Internal Article"
+        # Verify access_level was converted to enum and passed to SDK
+        call_args = mock_client.articles.update_with_content.call_args
+        assert call_args[1]["access_level"] == ArticleAccessLevel.INTERNAL
+
+    @pytest.mark.asyncio
+    async def test_update_with_tags(self, mock_ctx, mock_client):
+        """Test updating an article with tags."""
+        mock_article = _make_mock_article(
+            id="article-1",
+            title="Tagged Article",
+            status="published",
+        )
+        mock_client.articles.update_with_content.return_value = mock_article
+
+        result = await devrev_articles_update(
+            mock_ctx,
+            id="article-1",
+            tags=["don:core:dvrv-us-1:devo/1:tag/1"],
+        )
+
+        assert result["title"] == "Tagged Article"
+        # Verify tags were converted to SetTagWithValue and passed to SDK
+        call_args = mock_client.articles.update_with_content.call_args
+        tags_arg = call_args[1]["tags"]
+        assert len(tags_arg) == 1
+        assert tags_arg[0].id == "don:core:dvrv-us-1:devo/1:tag/1"
+
+    @pytest.mark.asyncio
+    async def test_update_with_invalid_access_level(self, mock_ctx, mock_client):
+        """Test updating an article with invalid access_level raises error."""
+        with pytest.raises(RuntimeError, match="Invalid access level"):
+            await devrev_articles_update(
+                mock_ctx,
+                id="article-1",
+                access_level="invalid_level",
+            )
+
+    @pytest.mark.asyncio
+    async def test_update_with_empty_tags_removes_all(self, mock_ctx, mock_client):
+        """Test updating with empty tags list removes all tags."""
+        mock_article = _make_mock_article(
+            id="article-1",
+            title="No Tags Article",
+            status="published",
+        )
+        mock_client.articles.update_with_content.return_value = mock_article
+
+        result = await devrev_articles_update(
+            mock_ctx,
+            id="article-1",
+            tags=[],
+        )
+
+        assert result["title"] == "No Tags Article"
+        # Verify empty list is passed (not None) to clear tags
+        call_args = mock_client.articles.update_with_content.call_args
+        tags_arg = call_args[1]["tags"]
+        assert tags_arg is not None
+        assert tags_arg == []
+
+    @pytest.mark.asyncio
+    async def test_create_with_empty_tags(self, mock_ctx, mock_client):
+        """Test creating with empty tags list passes empty list (not None)."""
+        mock_article = _make_mock_article(
+            title="No Tags Article",
+            description="Content without tags",
+        )
+        mock_client.articles.create_with_content.return_value = mock_article
+
+        result = await devrev_articles_create(
+            mock_ctx,
+            title="No Tags Article",
+            content="Content without tags",
+            owned_by=["don:identity:dvrv-us-1:devo/test:devu/1"],
+            tags=[],
+        )
+
+        assert result["title"] == "No Tags Article"
+        # Verify empty list is passed (not None)
+        call_args = mock_client.articles.create_with_content.call_args
+        tags_arg = call_args[1]["tags"]
+        assert tags_arg is not None
+        assert tags_arg == []
+
 
 class TestArticlesDeleteTool:
     """Tests for devrev_articles_delete tool."""

{devrev_python_sdk-2.9.0 → devrev_python_sdk-2.10.0}/tests/unit/test_articles_unified.py

@@ -856,6 +856,87 @@ class TestUpdateWithContent:
         assert "applies_to_parts" in data
         assert data["applies_to_parts"]["set"] == []
 
+    def test_update_with_content_access_level_only(
+        self,
+        articles_service: ArticlesService,
+        mock_article: Article,
+        mock_http_client: MagicMock,
+    ) -> None:
+        """Test updating only access_level."""
+        from devrev.models.articles import ArticleAccessLevel
+
+        mock_response = MagicMock()
+        mock_response.json.return_value = {"article": mock_article.model_dump(mode="json")}
+        mock_http_client.post.return_value = mock_response
+
+        result = articles_service.update_with_content(
+            "article-123",
+            access_level=ArticleAccessLevel.INTERNAL,
+        )
+
+        assert result.id == "article-123"
+        # Verify update was called with access_level
+        post_call = mock_http_client.post.call_args
+        assert "articles.update" in post_call[0][0]
+        data = post_call[1]["data"]
+        assert data["access_level"] == "internal"
+
+    def test_update_with_content_tags_only(
+        self,
+        articles_service: ArticlesService,
+        mock_article: Article,
+        mock_http_client: MagicMock,
+    ) -> None:
+        """Test updating only tags."""
+        from devrev.models.base import SetTagWithValue
+
+        mock_response = MagicMock()
+        mock_response.json.return_value = {"article": mock_article.model_dump(mode="json")}
+        mock_http_client.post.return_value = mock_response
+
+        result = articles_service.update_with_content(
+            "article-123",
+            tags=[SetTagWithValue(id="don:core:dvrv-us-1:devo/1:tag/1")],
+        )
+
+        assert result.id == "article-123"
+        # Verify update was called with tags wrapped in set
+        post_call = mock_http_client.post.call_args
+        assert "articles.update" in post_call[0][0]
+        data = post_call[1]["data"]
+        assert "tags" in data
+        assert data["tags"]["set"] == [{"id": "don:core:dvrv-us-1:devo/1:tag/1"}]
+
+    def test_update_with_content_access_level_and_tags(
+        self,
+        articles_service: ArticlesService,
+        mock_article: Article,
+        mock_http_client: MagicMock,
+    ) -> None:
+        """Test updating access_level and tags together."""
+        from devrev.models.articles import ArticleAccessLevel
+        from devrev.models.base import SetTagWithValue
+
+        mock_response = MagicMock()
+        mock_response.json.return_value = {"article": mock_article.model_dump(mode="json")}
+        mock_http_client.post.return_value = mock_response
+
+        result = articles_service.update_with_content(
+            "article-123",
+            access_level=ArticleAccessLevel.EXTERNAL,
+            tags=[
+                SetTagWithValue(id="don:core:dvrv-us-1:devo/1:tag/1"),
+                SetTagWithValue(id="don:core:dvrv-us-1:devo/1:tag/2"),
+            ],
+        )
+
+        assert result.id == "article-123"
+        post_call = mock_http_client.post.call_args
+        data = post_call[1]["data"]
+        assert data["access_level"] == "external"
+        assert "tags" in data
+        assert len(data["tags"]["set"]) == 2
+
 
 # ============================================================================
 # Async Tests
@@ -1526,3 +1607,85 @@ class TestUpdateWithContentAsync:
         data = post_call[1]["data"]
         assert "applies_to_parts" in data
         assert data["applies_to_parts"]["set"] == []
+
+    @pytest.mark.asyncio
+    async def test_async_update_with_content_access_level_only(
+        self,
+        async_articles_service: AsyncArticlesService,
+        mock_article: Article,
+        mock_async_http_client: MagicMock,
+    ) -> None:
+        """Test async updating only access_level."""
+        from devrev.models.articles import ArticleAccessLevel
+
+        mock_response = MagicMock()
+        mock_response.json.return_value = {"article": mock_article.model_dump(mode="json")}
+        mock_async_http_client.post.return_value = mock_response
+
+        result = await async_articles_service.update_with_content(
+            "article-123",
+            access_level=ArticleAccessLevel.INTERNAL,
+        )
+
+        assert result.id == "article-123"
+        post_call = mock_async_http_client.post.call_args
+        assert "articles.update" in post_call[0][0]
+        data = post_call[1]["data"]
+        assert data["access_level"] == "internal"
+
+    @pytest.mark.asyncio
+    async def test_async_update_with_content_tags_only(
+        self,
+        async_articles_service: AsyncArticlesService,
+        mock_article: Article,
+        mock_async_http_client: MagicMock,
+    ) -> None:
+        """Test async updating only tags."""
+        from devrev.models.base import SetTagWithValue
+
+        mock_response = MagicMock()
+        mock_response.json.return_value = {"article": mock_article.model_dump(mode="json")}
+        mock_async_http_client.post.return_value = mock_response
+
+        result = await async_articles_service.update_with_content(
+            "article-123",
+            tags=[SetTagWithValue(id="don:core:dvrv-us-1:devo/1:tag/1")],
+        )
+
+        assert result.id == "article-123"
+        post_call = mock_async_http_client.post.call_args
+        assert "articles.update" in post_call[0][0]
+        data = post_call[1]["data"]
+        assert "tags" in data
+        assert data["tags"]["set"] == [{"id": "don:core:dvrv-us-1:devo/1:tag/1"}]
+
+    @pytest.mark.asyncio
+    async def test_async_update_with_content_access_level_and_tags(
+        self,
+        async_articles_service: AsyncArticlesService,
+        mock_article: Article,
+        mock_async_http_client: MagicMock,
+    ) -> None:
+        """Test async updating access_level and tags together."""
+        from devrev.models.articles import ArticleAccessLevel
+        from devrev.models.base import SetTagWithValue
+
+        mock_response = MagicMock()
+        mock_response.json.return_value = {"article": mock_article.model_dump(mode="json")}
+        mock_async_http_client.post.return_value = mock_response
+
+        result = await async_articles_service.update_with_content(
+            "article-123",
+            access_level=ArticleAccessLevel.EXTERNAL,
+            tags=[
+                SetTagWithValue(id="don:core:dvrv-us-1:devo/1:tag/1"),
+                SetTagWithValue(id="don:core:dvrv-us-1:devo/1:tag/2"),
+            ],
+        )
+
+        assert result.id == "article-123"
+        post_call = mock_async_http_client.post.call_args
+        data = post_call[1]["data"]
+        assert data["access_level"] == "external"
+        assert "tags" in data
+        assert len(data["tags"]["set"]) == 2