devrev-Python-SDK 3.0.4__tar.gz → 3.1.0__tar.gz

{devrev_python_sdk-3.0.4 → devrev_python_sdk-3.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devrev-Python-SDK
-Version: 3.0.4
+Version: 3.1.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
@@ -75,7 +75,7 @@ Description-Content-Type: text/markdown
 
 # py-devrev
 
-A modern, type-safe Python SDK for the DevRev API.
+A modern, type-safe Python SDK and MCP for the DevRev API.
 
 [![Built with Augment](https://img.shields.io/badge/Built%20with-Auggie-6366f1?logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0id2hpdGUiPjxwYXRoIGQ9Ik0xMiAyTDIgMTloMjBMMTIgMnptMCAzLjc1TDE4LjI1IDE3SDUuNzVMMTIgNS43NXoiLz48L3N2Zz4=)](https://www.augmentcode.com/)
 [![PyPI Version](https://img.shields.io/pypi/v/devrev-python-sdk.svg)](https://pypi.org/project/devrev-Python-SDK/)
@@ -159,7 +159,7 @@ This SDK is generated and maintained from the official DevRev OpenAPI specificat
 
 ### MCP Server (AI Integration)
 
-- ✅ **78+ MCP Tools** — Full CRUD for tickets, accounts, users, articles, and all DevRev resources
+- ✅ **83+ MCP Tools** — Full CRUD for tickets, accounts, users, articles, webhooks, and all DevRev resources
 - ✅ **7 Resource Templates** — `devrev://` URI scheme for AI-accessible data browsing
 - ✅ **8 Workflow Prompts** — Pre-built triage, escalation, investigation, and reporting workflows
 - ✅ **3 Transport Modes** — stdio (local), Streamable HTTP (production), SSE (legacy)
@@ -215,17 +215,6 @@ for account in accounts:
 work = client.works.get(id="don:core:...")
 print(f"Work: {work.title} - Status: {work.stage.name}")
 
-# Ticket integrations can read optional account/sentiment/SLA fields
-ticket = client.works.get(id="don:core:dvrv-us-1:devo/1:ticket/123")
-print(ticket.rev_org, ticket.account, ticket.needs_response)
-
-# Use a supported raw escape hatch when the API returns newer fields
-raw_ticket = client.works.get_raw(id="don:core:dvrv-us-1:devo/1:ticket/123")
-print(raw_ticket["work"].keys())
-
-# List survey/CSAT responses for a ticket without using private _http
-survey_responses = client.survey_responses.list(object_id=ticket.id)
-
 # Create a new ticket
 ticket = client.works.create(
     title="Bug: Login page not loading",
@@ -308,7 +297,6 @@ The SDK provides complete coverage of all 209 DevRev public API endpoints, organ
 |---------|-----------|-------------|
 | **Articles** | 5 | Knowledge base articles |
 | **Conversations** | 5 | Customer conversations |
-| **Survey Responses** | 1 | Survey and CSAT response listing |
 | **Timeline Entries** | 5 | Activity timeline management |
 | **Tags** | 5 | Tagging and categorization |
 
@@ -737,7 +725,7 @@ The DevRev MCP Server exposes the full DevRev platform as [Model Context Protoco
 
 ### MCP Server Features
 
-- **78+ MCP Tools** — Full CRUD for tickets, accounts, users, conversations, articles, parts, tags, groups, timeline, links, SLAs, plus beta tools (search, recommendations, incidents, engagements)
+- **83+ MCP Tools** — Full CRUD for tickets, accounts, users, conversations, articles, parts, tags, groups, timeline, links, SLAs, webhooks, plus beta tools (search, recommendations, incidents, engagements)
 - **7 Resource Templates** — `devrev://` URI scheme for browsing tickets, accounts, articles, users, parts, conversations
 - **8 Workflow Prompts** — Triage, draft response, escalate, summarize account, investigate, weekly report, find similar, onboard customer
 - **3 Transports** — stdio (local dev), Streamable HTTP (production), SSE (legacy)

{devrev_python_sdk-3.0.4 → devrev_python_sdk-3.1.0}/README.md

@@ -1,6 +1,6 @@
 # py-devrev
 
-A modern, type-safe Python SDK for the DevRev API.
+A modern, type-safe Python SDK and MCP for the DevRev API.
 
 [![Built with Augment](https://img.shields.io/badge/Built%20with-Auggie-6366f1?logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0id2hpdGUiPjxwYXRoIGQ9Ik0xMiAyTDIgMTloMjBMMTIgMnptMCAzLjc1TDE4LjI1IDE3SDUuNzVMMTIgNS43NXoiLz48L3N2Zz4=)](https://www.augmentcode.com/)
 [![PyPI Version](https://img.shields.io/pypi/v/devrev-python-sdk.svg)](https://pypi.org/project/devrev-Python-SDK/)
@@ -84,7 +84,7 @@ This SDK is generated and maintained from the official DevRev OpenAPI specificat
 
 ### MCP Server (AI Integration)
 
-- ✅ **78+ MCP Tools** — Full CRUD for tickets, accounts, users, articles, and all DevRev resources
+- ✅ **83+ MCP Tools** — Full CRUD for tickets, accounts, users, articles, webhooks, and all DevRev resources
 - ✅ **7 Resource Templates** — `devrev://` URI scheme for AI-accessible data browsing
 - ✅ **8 Workflow Prompts** — Pre-built triage, escalation, investigation, and reporting workflows
 - ✅ **3 Transport Modes** — stdio (local), Streamable HTTP (production), SSE (legacy)
@@ -140,17 +140,6 @@ for account in accounts:
 work = client.works.get(id="don:core:...")
 print(f"Work: {work.title} - Status: {work.stage.name}")
 
-# Ticket integrations can read optional account/sentiment/SLA fields
-ticket = client.works.get(id="don:core:dvrv-us-1:devo/1:ticket/123")
-print(ticket.rev_org, ticket.account, ticket.needs_response)
-
-# Use a supported raw escape hatch when the API returns newer fields
-raw_ticket = client.works.get_raw(id="don:core:dvrv-us-1:devo/1:ticket/123")
-print(raw_ticket["work"].keys())
-
-# List survey/CSAT responses for a ticket without using private _http
-survey_responses = client.survey_responses.list(object_id=ticket.id)
-
 # Create a new ticket
 ticket = client.works.create(
     title="Bug: Login page not loading",
@@ -233,7 +222,6 @@ The SDK provides complete coverage of all 209 DevRev public API endpoints, organ
 |---------|-----------|-------------|
 | **Articles** | 5 | Knowledge base articles |
 | **Conversations** | 5 | Customer conversations |
-| **Survey Responses** | 1 | Survey and CSAT response listing |
 | **Timeline Entries** | 5 | Activity timeline management |
 | **Tags** | 5 | Tagging and categorization |
 
@@ -662,7 +650,7 @@ The DevRev MCP Server exposes the full DevRev platform as [Model Context Protoco
 
 ### MCP Server Features
 
-- **78+ MCP Tools** — Full CRUD for tickets, accounts, users, conversations, articles, parts, tags, groups, timeline, links, SLAs, plus beta tools (search, recommendations, incidents, engagements)
+- **83+ MCP Tools** — Full CRUD for tickets, accounts, users, conversations, articles, parts, tags, groups, timeline, links, SLAs, webhooks, plus beta tools (search, recommendations, incidents, engagements)
 - **7 Resource Templates** — `devrev://` URI scheme for browsing tickets, accounts, articles, users, parts, conversations
 - **8 Workflow Prompts** — Triage, draft response, escalate, summarize account, investigate, weekly report, find similar, onboard customer
 - **3 Transports** — stdio (local dev), Streamable HTTP (production), SSE (legacy)

{devrev_python_sdk-3.0.4 → devrev_python_sdk-3.1.0}/docs/api/index.md

@@ -44,7 +44,6 @@ All API operations are organized into service classes:
 | [Parts](services/parts.md) | Product components | 5 |
 | [Articles](services/articles.md) | Knowledge base | 5 |
 | [Conversations](services/conversations.md) | Customer conversations | 5 |
-| [Survey Responses](services/survey-responses.md) | Survey and CSAT responses | 1 |
 | [Tags](services/tags.md) | Categorization | 5 |
 | [Groups](services/groups.md) | User groups | 6 |
 | [Webhooks](services/webhooks.md) | Event notifications | 6 |
@@ -78,7 +77,6 @@ Request and response models:
 |--------|-------------|
 | [Base](models/base.md) | Common base classes |
 | [Accounts](models/accounts.md) | Account models |
-| [Survey Responses](models/survey-responses.md) | Survey response models |
 | [Works](models/works.md) | Work item models |
 | [Users](models/users.md) | User models |
 

{devrev_python_sdk-3.0.4 → devrev_python_sdk-3.1.0}/docs/api/models/index.md

@@ -30,7 +30,6 @@ Models for specific resources:
 | Resource | Description |
 |----------|-------------|
 | [Accounts](accounts.md) | Customer account models |
-| [Survey Responses](survey-responses.md) | Survey response list and payload models |
 | [Works](works.md) | Work item models (tickets, issues) |
 | [Users](users.md) | User models (dev and rev users) |
 

{devrev_python_sdk-3.0.4 → devrev_python_sdk-3.1.0}/docs/api/models/works.md

@@ -111,9 +111,6 @@ print(f"Stage: {work.stage.name if work.stage else 'N/A'}")
 
 if work.type == WorkType.TICKET:
     print(f"Severity: {work.severity}")
-    print(f"Account: {work.account}")
-    print(f"Rev org: {work.rev_org}")
-    print(f"Needs response: {work.needs_response}")
 elif work.type == WorkType.ISSUE:
     print(f"Priority: {work.priority}")
 ```

{devrev_python_sdk-3.0.4 → devrev_python_sdk-3.1.0}/docs/api/services/index.md

@@ -36,7 +36,6 @@ client.dev_users     # DevUsersService
 |---------|-------------|-----------|
 | **Articles** | Knowledge base articles with unified content management | [articles](articles.md) |
 | **Conversations** | Customer conversations | [conversations](conversations.md) |
-| **Survey Responses** | Survey and CSAT responses | [survey-responses](survey-responses.md) |
 | **Tags** | Categorization | [tags](tags.md) |
 | **Timeline Entries** | Activity tracking | [timeline-entries](timeline-entries.md) |
 

{devrev_python_sdk-3.0.4 → devrev_python_sdk-3.1.0}/docs/api/services/works.md

@@ -13,7 +13,6 @@ issues (engineering), and tasks.
       members:
         - list
         - get
-        - get_raw
         - create
         - update
         - delete
@@ -58,39 +57,13 @@ response = client.works.list(
 ### Get Work Item
 
 ```python
-work = client.works.get(id="don:core:dvrv-us-1:devo/1:ticket/123")
+response = client.works.get(id="don:core:dvrv-us-1:devo/1:ticket/123")
+work = response.work
 print(f"Title: {work.title}")
 print(f"Type: {work.type}")
 print(f"Stage: {work.stage.name if work.stage else 'N/A'}")
 ```
 
-### Get Raw Work Payload
-
-Use `get_raw` when the REST API returns a newly-added field that is not yet
-modeled by the typed `Work` object. This keeps callers on a supported SDK API
-instead of relying on the private `_http` transport.
-
-```python
-payload = client.works.get_raw(id="don:core:dvrv-us-1:devo/1:ticket/123")
-raw_work = payload["work"]
-print(raw_work.get("rev_org"))
-```
-
-### Ticket Account Association
-
-For tickets, the typed `Work` model now includes optional account-association
-fields when the API returns them. Prefer the typed fields first, and use
-`get_raw` only as a fallback for workspace-specific or newly-added fields.
-
-```python
-ticket = client.works.get(id="don:core:dvrv-us-1:devo/1:ticket/123")
-
-if ticket.rev_org:
-    print(f"Ticket rev org: {ticket.rev_org}")
-if ticket.account:
-    print(f"Ticket account: {ticket.account}")
-```
-
 ### Create Ticket
 
 ```python

{devrev_python_sdk-3.0.4 → devrev_python_sdk-3.1.0}/docs/changelog.md

@@ -13,21 +13,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Fixed
 
-## [3.0.4] - 2026-05-03
+## [3.1.0] - 2026-06-16
 
 ### Added
 
-- **Ticket SDK coverage enhancements** (CUSS-370, GitHub #220) — Added optional
-  typed `Work` fields used by ticket integrations (`account`, `rev_org`,
-  sentiment fields, `sla_summary`, `needs_response`, channels, group,
-  `is_frozen`, and `visibility`), a public `WorksService.get_raw` /
-  `AsyncWorksService.get_raw` escape hatch for raw `/works.get` payloads, and
-  new sync/async `survey_responses.list(...)` support for
-  `/surveys.responses.list`.
-
-### Changed
-
-### Fixed
+- **Webhook management MCP tools** (CSS-1041) — New `devrev_webhooks_*` MCP
+  tools exposing the existing `WebhooksService` through the MCP server:
+  `devrev_webhooks_list` and `devrev_webhooks_get` (read-only), plus
+  `devrev_webhooks_create`, `devrev_webhooks_update`, and
+  `devrev_webhooks_delete` (registered only when destructive tools are
+  enabled). The module follows the established tool conventions (DON ID
+  validation, paginated list responses, `WebhookStatus` resolution on update)
+  and is registered in the core (non-beta) tool block. Documentation in
+  `docs/mcp/tools-reference.md` now covers all five tools plus an advisory
+  section on event types, target URL requirements, the signing `secret`, and
+  the webhook status lifecycle.
 
 ## [3.0.1] - 2026-04-22
 

{devrev_python_sdk-3.0.4 → devrev_python_sdk-3.1.0}/docs/mcp/tools-reference.md

@@ -6,7 +6,7 @@ icon: material/tools
 
 Complete reference of all MCP capabilities provided by the DevRev MCP Server.
 
-## Tools (83+)
+## Tools (88+)
 
 Tools are the primary way AI assistants interact with DevRev. Each tool maps to one or more DevRev API endpoints.
 
@@ -148,12 +148,37 @@ issues (engineering), and tasks.
 
 ### Webhooks
 
+Webhooks deliver DevRev events to an external HTTPS endpoint. Each webhook has a
+target `url`, an optional list of `event_types` to subscribe to (defaults to all
+events), and an optional `secret` used to sign payloads so the receiver can
+verify authenticity. A webhook's `status` moves through `unverified` → `active`
+once DevRev confirms the endpoint, and can be set to `inactive` to pause
+delivery.
+
 | Tool | Description |
 |------|-------------|
 | `devrev_webhooks_list` | List webhooks |
 | `devrev_webhooks_get` | Get webhook details |
 | `devrev_webhooks_create` | Create a webhook |
-| `devrev_webhooks_update` | Update a webhook |
+| `devrev_webhooks_update` | Update a webhook (url, event types, status) |
+| `devrev_webhooks_delete` | Delete a webhook |
+
+**Managing webhooks**
+
+- **Target URL** must be a publicly reachable HTTPS endpoint that responds to
+  DevRev's verification handshake; until it does, the webhook stays
+  `unverified` and no events are delivered.
+- **Event types** scope which events are sent. Omit `event_types` on create to
+  receive all event types, or pass a specific list (e.g. `work_created`,
+  `work_updated`) to narrow delivery.
+- **Secret** is a shared signing key — store it as a secret on the receiving
+  service and use it to verify each payload's signature. Never log or commit it.
+- **Status lifecycle**: `unverified` (awaiting handshake) → `active` (delivering)
+  ↔ `inactive` (paused). Use `devrev_webhooks_update` with `status` to pause or
+  resume a webhook.
+- **Typical workflow**: `devrev_webhooks_create` (register the endpoint) → verify
+  the endpoint so it becomes `active` → `devrev_webhooks_list` / `devrev_webhooks_get`
+  to confirm configuration → `devrev_webhooks_delete` when it is no longer needed.
 
 ### Beta Tools
 

{devrev_python_sdk-3.0.4 → devrev_python_sdk-3.1.0}/mkdocs.yml

@@ -169,7 +169,6 @@ nav:
       - Parts: api/services/parts.md
       - Articles: api/services/articles.md
       - Conversations: api/services/conversations.md
-      - Survey Responses: api/services/survey-responses.md
       - Tags: api/services/tags.md
       - Groups: api/services/groups.md
       - Webhooks: api/services/webhooks.md
@@ -181,7 +180,6 @@ nav:
       - api/models/index.md
       - Base: api/models/base.md
       - Accounts: api/models/accounts.md
-      - Survey Responses: api/models/survey-responses.md
       - Works: api/models/works.md
       - Users: api/models/users.md
   - Examples:

{devrev_python_sdk-3.0.4 → devrev_python_sdk-3.1.0}/pyproject.toml

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

{devrev_python_sdk-3.0.4 → devrev_python_sdk-3.1.0}/src/devrev/client.py

@@ -42,10 +42,6 @@ from devrev.services.rev_orgs import AsyncRevOrgsService, RevOrgsService
 from devrev.services.rev_users import AsyncRevUsersService, RevUsersService
 from devrev.services.search import AsyncSearchService, SearchService
 from devrev.services.slas import AsyncSlasService, SlasService
-from devrev.services.survey_responses import (
-    AsyncSurveyResponsesService,
-    SurveyResponsesService,
-)
 from devrev.services.tags import AsyncTagsService, TagsService
 from devrev.services.timeline_entries import (
     AsyncTimelineEntriesService,
@@ -168,7 +164,6 @@ class DevRevClient:
         self._rev_orgs = RevOrgsService(self._http)
         self._rev_users = RevUsersService(self._http)
         self._slas = SlasService(self._http)
-        self._survey_responses = SurveyResponsesService(self._http)
         self._tags = TagsService(self._http)
         self._timeline_entries = TimelineEntriesService(self._http)
         self._webhooks = WebhooksService(self._http)
@@ -264,11 +259,6 @@ class DevRevClient:
         """Access the SLAs service."""
         return self._slas
 
-    @property
-    def survey_responses(self) -> SurveyResponsesService:
-        """Access the Survey Responses service."""
-        return self._survey_responses
-
     @property
     def tags(self) -> TagsService:
         """Access the Tags service."""
@@ -502,7 +492,6 @@ class AsyncDevRevClient:
         self._rev_orgs = AsyncRevOrgsService(self._http)
         self._rev_users = AsyncRevUsersService(self._http)
         self._slas = AsyncSlasService(self._http)
-        self._survey_responses = AsyncSurveyResponsesService(self._http)
         self._tags = AsyncTagsService(self._http)
         self._timeline_entries = AsyncTimelineEntriesService(self._http)
         self._webhooks = AsyncWebhooksService(self._http)
@@ -598,11 +587,6 @@ class AsyncDevRevClient:
         """Access the SLAs service."""
         return self._slas
 
-    @property
-    def survey_responses(self) -> AsyncSurveyResponsesService:
-        """Access the Survey Responses service."""
-        return self._survey_responses
-
     @property
     def tags(self) -> AsyncTagsService:
         """Access the Tags service."""

{devrev_python_sdk-3.0.4 → devrev_python_sdk-3.1.0}/src/devrev/models/__init__.py

@@ -328,12 +328,6 @@ from devrev.models.slas import (
     SlasUpdateResponse,
     SlaTrackerStatus,
 )
-from devrev.models.survey_responses import (
-    SurveyResponse,
-    SurveyResponsesListMode,
-    SurveyResponsesListRequest,
-    SurveyResponsesListResponse,
-)
 from devrev.models.sync import (
     ExternalRef,
     StagedInfo,
@@ -705,11 +699,6 @@ __all__ = [
     "QuestionAnswersUpdateRequest",
     "QuestionAnswersUpdateResponse",
     "QuestionAnswersDeleteRequest",
-    # Survey Responses
-    "SurveyResponse",
-    "SurveyResponsesListMode",
-    "SurveyResponsesListRequest",
-    "SurveyResponsesListResponse",
     # Recommendations
     "MessageRole",
     "ChatMessage",

{devrev_python_sdk-3.0.4 → devrev_python_sdk-3.1.0}/src/devrev/models/works.py

@@ -96,48 +96,6 @@ class Work(DevRevResponseModel):
     actual_close_date: datetime | None = Field(default=None, description="Actual close date")
     custom_fields: dict[str, Any] | None = Field(default=None, description="Custom fields")
     external_ref: str | None = Field(default=None, description="External reference")
-    account: dict[str, Any] | str | None = Field(
-        default=None,
-        description="Account associated with the ticket/work, when returned by the API",
-    )
-    rev_org: dict[str, Any] | str | None = Field(
-        default=None,
-        description="Rev organization associated with the ticket/work",
-    )
-    sentiment: dict[str, Any] | str | None = Field(
-        default=None,
-        description="Current ticket sentiment, when returned by the API",
-    )
-    sentiment_summary: dict[str, Any] | str | None = Field(
-        default=None,
-        description="Structured or textual sentiment summary",
-    )
-    sentiment_modified_date: datetime | None = Field(
-        default=None,
-        description="When ticket sentiment was last modified",
-    )
-    sla_summary: dict[str, Any] | None = Field(default=None, description="Ticket SLA summary")
-    needs_response: bool | None = Field(
-        default=None,
-        description="Whether the ticket needs a customer response",
-    )
-    channels: list[dict[str, Any] | str] | None = Field(
-        default=None,
-        description="Channels associated with the ticket",
-    )
-    source_channel: dict[str, Any] | str | None = Field(
-        default=None,
-        description="Source channel that created the ticket",
-    )
-    group: dict[str, Any] | str | None = Field(
-        default=None,
-        description="Group associated with the work item",
-    )
-    is_frozen: bool | None = Field(default=None, description="Whether the work item is frozen")
-    visibility: dict[str, Any] | str | None = Field(
-        default=None,
-        description="Work item visibility, when returned by the API",
-    )
 
 
 class WorkSummary(DevRevResponseModel):

{devrev_python_sdk-3.0.4 → devrev_python_sdk-3.1.0}/src/devrev/services/__init__.py

@@ -38,7 +38,6 @@ from devrev.services.rev_orgs import AsyncRevOrgsService, RevOrgsService
 from devrev.services.rev_users import AsyncRevUsersService, RevUsersService
 from devrev.services.search import AsyncSearchService, SearchService
 from devrev.services.slas import AsyncSlasService, SlasService
-from devrev.services.survey_responses import AsyncSurveyResponsesService, SurveyResponsesService
 from devrev.services.tags import AsyncTagsService, TagsService
 from devrev.services.timeline_entries import (
     AsyncTimelineEntriesService,
@@ -113,9 +112,6 @@ __all__ = [
     # SLAs
     "SlasService",
     "AsyncSlasService",
-    # Survey Responses
-    "SurveyResponsesService",
-    "AsyncSurveyResponsesService",
     # Tags
     "TagsService",
     "AsyncTagsService",

{devrev_python_sdk-3.0.4 → devrev_python_sdk-3.1.0}/src/devrev/services/works.py

@@ -147,21 +147,6 @@ class WorksService(BaseService):
         response = self._post("/works.get", request, WorksGetResponse)
         return response.work
 
-    def get_raw(self, id: str) -> dict[str, Any]:
-        """Get the raw API payload for a work item.
-
-        Use this supported escape hatch when the DevRev API returns fields that
-        are not yet represented on the typed :class:`Work` model.
-
-        Args:
-            id: Work item ID
-
-        Returns:
-            Raw ``/works.get`` response payload.
-        """
-        request = WorksGetRequest(id=id)
-        return self._post("/works.get", request)
-
     def list(
         self,
         *,
@@ -454,11 +439,6 @@ class AsyncWorksService(AsyncBaseService):
         response = await self._post("/works.get", request, WorksGetResponse)
         return response.work
 
-    async def get_raw(self, id: str) -> dict[str, Any]:
-        """Get the raw API payload for a work item."""
-        request = WorksGetRequest(id=id)
-        return await self._post("/works.get", request)
-
     async def list(
         self,
         *,

{devrev_python_sdk-3.0.4 → devrev_python_sdk-3.1.0}/src/devrev_mcp/server.py

@@ -249,6 +249,7 @@ from devrev_mcp.tools import slas as _slas_tools  # noqa: E402, F401
 from devrev_mcp.tools import tags as _tags_tools  # noqa: E402, F401
 from devrev_mcp.tools import timeline as _timeline_tools  # noqa: E402, F401
 from devrev_mcp.tools import users as _users_tools  # noqa: E402, F401
+from devrev_mcp.tools import webhooks as _webhooks_tools  # noqa: E402, F401
 from devrev_mcp.tools import works as _works_tools  # noqa: E402, F401
 
 # Beta tools (only if beta tools are enabled)

devrev_python_sdk-3.1.0/src/devrev_mcp/tools/webhooks.py

@@ -0,0 +1,153 @@
+"""MCP tools for DevRev webhook operations."""
+
+from __future__ import annotations
+
+import logging
+from typing import Any
+
+from mcp.server.fastmcp import Context
+
+from devrev.exceptions import DevRevError
+from devrev.models.webhooks import (
+    WebhooksCreateRequest,
+    WebhooksDeleteRequest,
+    WebhooksGetRequest,
+    WebhooksListRequest,
+    WebhookStatus,
+    WebhooksUpdateRequest,
+)
+from devrev_mcp.server import _config, mcp
+from devrev_mcp.utils.don_id import validate_don_id
+from devrev_mcp.utils.errors import format_devrev_error
+from devrev_mcp.utils.formatting import serialize_model, serialize_models
+from devrev_mcp.utils.pagination import clamp_page_size
+
+logger = logging.getLogger(__name__)
+
+
+@mcp.tool()
+async def devrev_webhooks_list(
+    ctx: Context[Any, Any, Any],
+    cursor: str | None = None,
+    limit: int | None = None,
+) -> dict[str, Any]:
+    """List DevRev webhooks.
+
+    Args:
+        cursor: Pagination cursor from a previous response.
+        limit: Maximum number of items to return (default: 25, max: 100).
+    """
+    app = ctx.request_context.lifespan_context
+    try:
+        request = WebhooksListRequest(
+            cursor=cursor,
+            limit=clamp_page_size(
+                limit, default=app.config.default_page_size, maximum=app.config.max_page_size
+            ),
+        )
+        webhooks = await app.get_client().webhooks.list(request)
+        items = serialize_models(list(webhooks))
+        return {"count": len(items), "webhooks": items}
+    except DevRevError as e:
+        raise RuntimeError(format_devrev_error(e)) from e
+
+
+@mcp.tool()
+async def devrev_webhooks_get(
+    ctx: Context[Any, Any, Any],
+    id: str,
+) -> dict[str, Any]:
+    """Get a DevRev webhook by ID.
+
+    Args:
+        id: Webhook ID (e.g., "don:integration:dvrv-us-1:devo/1:webhook/123").
+    """
+    validate_don_id(id, "webhook", "devrev_webhooks_get")
+    app = ctx.request_context.lifespan_context
+    try:
+        request = WebhooksGetRequest(id=id)
+        webhook = await app.get_client().webhooks.get(request)
+        return serialize_model(webhook)
+    except DevRevError as e:
+        raise RuntimeError(format_devrev_error(e)) from e
+
+
+# Destructive tools (only registered when enabled)
+if _config.enable_destructive_tools:
+
+    @mcp.tool()
+    async def devrev_webhooks_create(
+        ctx: Context[Any, Any, Any],
+        url: str,
+        event_types: list[str] | None = None,
+        secret: str | None = None,
+    ) -> dict[str, Any]:
+        """Create a new DevRev webhook.
+
+        Args:
+            url: Target URL that will receive webhook event POSTs.
+            event_types: Event types to subscribe to (default: all events).
+            secret: Shared secret used to sign and verify webhook payloads.
+        """
+        app = ctx.request_context.lifespan_context
+        try:
+            request = WebhooksCreateRequest(url=url, event_types=event_types, secret=secret)
+            webhook = await app.get_client().webhooks.create(request)
+            return serialize_model(webhook)
+        except DevRevError as e:
+            raise RuntimeError(format_devrev_error(e)) from e
+
+    @mcp.tool()
+    async def devrev_webhooks_update(
+        ctx: Context[Any, Any, Any],
+        id: str,
+        url: str | None = None,
+        event_types: list[str] | None = None,
+        status: str | None = None,
+    ) -> dict[str, Any]:
+        """Update a DevRev webhook.
+
+        Args:
+            id: Webhook ID to update.
+            url: New target URL.
+            event_types: New list of event types to subscribe to.
+            status: New status (active, inactive, unverified).
+        """
+        validate_don_id(id, "webhook", "devrev_webhooks_update")
+        app = ctx.request_context.lifespan_context
+        try:
+            resolved_status: WebhookStatus | None = None
+            if status is not None:
+                try:
+                    resolved_status = WebhookStatus(status.lower())
+                except ValueError as e:
+                    raise RuntimeError(
+                        f"Invalid webhook status '{status}'. "
+                        "Valid values: active, inactive, unverified."
+                    ) from e
+            request = WebhooksUpdateRequest(
+                id=id, url=url, event_types=event_types, status=resolved_status
+            )
+            webhook = await app.get_client().webhooks.update(request)
+            return serialize_model(webhook)
+        except DevRevError as e:
+            raise RuntimeError(format_devrev_error(e)) from e
+
+    @mcp.tool()
+    async def devrev_webhooks_delete(
+        ctx: Context[Any, Any, Any],
+        id: str,
+    ) -> dict[str, Any]:
+        """Delete a DevRev webhook.
+
+        Args:
+            id: Webhook ID to delete.
+        """
+        validate_don_id(id, "webhook", "devrev_webhooks_delete")
+        app = ctx.request_context.lifespan_context
+        try:
+            request = WebhooksDeleteRequest(id=id)
+            await app.get_client().webhooks.delete(request)
+            return {"deleted": True, "id": id}
+        except DevRevError as e:
+            raise RuntimeError(format_devrev_error(e)) from e