> ## Documentation Index
> Fetch the complete documentation index at: https://developers.podero.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update a notification webhook

> Update a webhook's delivery switch and/or its subscribed topics. Only the fields
present in the request change; ``topics`` replaces the whole set. The endpoint URL
is immutable — delete and recreate to change it. A webhook that does not exist or
belongs to another organization is reported as not found.



## OpenAPI

````yaml https://app.podero.com/api/partners/v2.0/openapi.json patch /api/partners/v2.0/org/{org_id}/notifications/webhooks/{webhook_id}
openapi: 3.1.0
info:
  title: Podero Partner API
  version: '2.0'
  description: >-
    This API provides a unified interaction point for Podero's partner
    companies.


    The goal of this API is to give partners easily integratable endpoints that
    don't require extensive software

    development. For this reason, the endpoints focus around user and device
    management, setting of preferences

    and high level device controls.


    While direct control of devices is implemented for special use cases such as
    pause power, we abstract away low level

    direct device steering so developers and partners can focus on delivering
    maximum value to end users.
  termsOfService: https://www.podero.com/terms-and-conditions
servers: []
security: []
paths:
  /api/partners/v2.0/org/{org_id}/notifications/webhooks/{webhook_id}:
    patch:
      tags:
        - Notification Webhooks
      summary: Update a notification webhook
      description: >-
        Update a webhook's delivery switch and/or its subscribed topics. Only
        the fields

        present in the request change; ``topics`` replaces the whole set. The
        endpoint URL

        is immutable — delete and recreate to change it. A webhook that does not
        exist or

        belongs to another organization is reported as not found.
      operationId: >-
        integrations_api_api_v2_organizations_notifications_webhooks_router_update_webhook
      parameters:
        - in: path
          name: org_id
          schema:
            description: The organization ID of the user's organization
            format: uuid
            title: Org Id
            type: string
          required: true
          description: The organization ID of the user's organization
        - in: path
          name: webhook_id
          schema:
            description: The webhook ID
            format: uuid
            title: Webhook Id
            type: string
          required: true
          description: The webhook ID
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WebhookUpdateInput'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WebhookOutput'
      security:
        - OAuth2: []
components:
  schemas:
    WebhookUpdateInput:
      description: >-
        Partial update of a webhook. Only the fields present change: ``enabled``
        toggles

        the delivery switch; ``topics`` replaces the full subscription set (an
        empty list

        clears it). The endpoint URL is immutable — delete and recreate to
        change it.
      properties:
        enabled:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Enabled
        topics:
          anyOf:
            - items:
                $ref: '#/components/schemas/Topic'
              type: array
            - type: 'null'
          title: Topics
      title: WebhookUpdateInput
      type: object
    WebhookOutput:
      description: >-
        Partner-facing view of a registered notification webhook, read from the

        ``Webhook`` projection. The owning organization is implicit in the URL,
        and the

        signing secret is never exposed here — it is surfaced once at creation
        and on

        rotation and nowhere else.
      properties:
        webhook_id:
          format: uuid
          title: Webhook Id
          type: string
        url:
          title: Url
          type: string
        enabled:
          default: true
          description: The webhook-level on/off switch
          title: Enabled
          type: boolean
        topics:
          description: Subscribed topics
          items: {}
          title: Topics
          type: array
        created_at:
          format: date-time
          title: Created At
          type: string
        updated_at:
          format: date-time
          title: Updated At
          type: string
      required:
        - webhook_id
        - url
        - created_at
        - updated_at
      title: WebhookOutput
      type: object
    Topic:
      enum:
        - device.action_required
        - device.information
      title: Topic
      type: string
  securitySchemes:
    OAuth2:
      type: oauth2
      flows:
        password:
          tokenUrl: /api/partners/v2.0/auth/token
          scopes: {}
        clientCredentials:
          tokenUrl: /api/partners/v2.0/auth/token
          scopes: {}

````