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

# Update webhook endpoint

> Update a webhook endpoint's URL, subscribed events, description, or active
state. Only provided fields change. The signing secret is never rotated here. This operation can change workspace data or trigger an external side effect; review the request before sending it and do not retry blindly after a timeout.



## OpenAPI

````yaml /openapi.json patch /api/v1/public/webhook-endpoints/{endpoint_id}
openapi: 3.1.0
info:
  description: >-
    Customer-facing API for managing outreach, leads, conversations, voice
    agents, knowledge bases, analytics, and webhooks.
  title: Sendora Public API
  version: 1.0.0
servers:
  - description: Production
    url: https://api.sendora.ai
security: []
tags:
  - description: Build, launch, pause and stop campaigns, and enroll leads.
    name: Campaigns
  - description: Create, update, tag, enrich and import leads.
    name: Leads
  - description: Group leads into reusable lists.
    name: Lead lists
  - description: Find new prospects and research existing leads.
    name: Prospecting
  - description: Read conversations and send messages to leads.
    name: Inbox
  - description: Manage workspace-wide suppressions.
    name: Do not contact
  - description: Manage the content your agents answer from.
    name: Knowledge bases
  - description: Create, configure, test and publish voice agents.
    name: Voice agents
  - description: Give agents actions such as booking, lookups and transfers.
    name: Agent tools
  - description: Embed a voice agent on your website.
    name: Voice widgets
  - description: Start voice calls and read call results.
    name: Calls
  - description: Browse and preview the voices an agent can use.
    name: Voices
  - description: List numbers, bring your own, and route calls.
    name: Phone numbers
  - description: List the channel accounts connected to the workspace.
    name: Connected accounts
  - description: Register endpoints and review deliveries.
    name: Webhooks
  - description: Drive the workspace assistant programmatically.
    name: Copilot
  - description: Read workspace and campaign performance.
    name: Analytics
  - description: Track asynchronous operations.
    name: Jobs
  - description: Manage client workspaces, plans and branding.
    name: Agency
paths:
  /api/v1/public/webhook-endpoints/{endpoint_id}:
    patch:
      tags:
        - Webhooks
      summary: Update webhook endpoint
      description: >-
        Update a webhook endpoint's URL, subscribed events, description, or
        active

        state. Only provided fields change. The signing secret is never rotated
        here. This operation can change workspace data or trigger an external
        side effect; review the request before sending it and do not retry
        blindly after a timeout.
      operationId: >-
        public_update_endpoint_api_v1_public_webhook_endpoints__endpoint_id__patch
      parameters:
        - description: 'The webhook endpoint''s id: the `id` from List webhook endpoints.'
          in: path
          name: endpoint_id
          required: true
          schema:
            title: Endpoint Id
            type: string
        - in: header
          name: X-API-Key
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: X-Api-Key
        - in: header
          name: Authorization
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Authorization
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WebhookEndpointUpdate'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/api__v1__public___webhook_shapes__WebhookEndpointOut
          description: Successful Response
        '400':
          description: >-
            The request is syntactically valid but cannot be processed with the
            supplied values.
        '401':
          description: The X-API-Key header is missing, invalid, expired, or revoked.
        '402':
          description: >-
            The workspace is suspended for billing, or the request would exceed
            a plan or usage limit.
        '403':
          description: >-
            The key is valid but lacks the required scope, or the workspace has
            no active plan, lacks the entitlement, or has this feature turned
            off or view-only.
        '404':
          description: >-
            The resource does not exist or is not owned by the authenticated
            workspace.
        '410':
          description: The workspace behind this key has been deleted.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
        '429':
          description: The operation is rate limited. Respect Retry-After before retrying.
        '500':
          description: >-
            An unexpected Sendora error occurred. Retry only if the operation is
            safe to repeat.
        '503':
          description: >-
            An entitlement or billing check is temporarily unavailable. Retry
            after the Retry-After interval.
      security:
        - ApiKeyAuth: []
      x-codeSamples:
        - label: cURL
          lang: bash
          source: >-
            curl -X PATCH
            'https://api.sendora.ai/api/v1/public/webhook-endpoints/YOUR_ID' -H
            "X-API-Key: $SENDORA_API_KEY" -H "Content-Type: application/json" \
              -d '{"description":"example","event_types":["example"],"is_active":true}'
        - label: Python
          lang: python
          source: >-
            import requests


            url =
            'https://api.sendora.ai/api/v1/public/webhook-endpoints/YOUR_ID'

            headers = {'X-API-Key': '$SENDORA_API_KEY'}

            response = requests.patch(url, headers=headers, json={'description':
            'example', 'event_types': ['example'], 'is_active': True})

            response.raise_for_status()

            print(response.json())
        - label: JavaScript
          lang: javascript
          source: >-
            const response = await
            fetch("https://api.sendora.ai/api/v1/public/webhook-endpoints/YOUR_ID",
            {
              method: "PATCH",
              headers: { 'X-API-Key': process.env.SENDORA_API_KEY, 'Content-Type': 'application/json' },
              body: JSON.stringify({"description": "example", "event_types": ["example"], "is_active": true}),
            });

            if (!response.ok) throw new Error(await response.text());

            console.log(await response.json());
        - label: Go
          lang: go
          source: >-
            req, err := http.NewRequest("PATCH",
            "https://api.sendora.ai/api/v1/public/webhook-endpoints/YOUR_ID",
            bytes.NewBufferString(`{"description": "example", "event_types":
            ["example"], "is_active": true}`))

            if err != nil { log.Fatal(err) }

            req.Header.Set("X-API-Key", os.Getenv("SENDORA_API_KEY"))

            req.Header.Set("Content-Type", "application/json")

            resp, err := http.DefaultClient.Do(req)

            if err != nil { log.Fatal(err) }

            defer resp.Body.Close()
components:
  schemas:
    WebhookEndpointUpdate:
      description: Partial update, only provided fields change.
      properties:
        description:
          anyOf:
            - type: string
            - type: 'null'
          description: Description returned by the Sendora API.
          title: Description
        event_types:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          description: Event types returned by the Sendora API.
          title: Event Types
        is_active:
          anyOf:
            - type: boolean
            - type: 'null'
          description: Is active returned by the Sendora API.
          title: Is Active
        url:
          anyOf:
            - format: uri
              maxLength: 2083
              minLength: 1
              type: string
            - type: 'null'
          description: Url returned by the Sendora API.
          title: Url
      required: []
      title: WebhookEndpointUpdate
      type: object
    api__v1__public___webhook_shapes__WebhookEndpointOut:
      properties:
        created_at:
          description: Created at returned by the Sendora API.
          title: Created At
          type: string
        description:
          anyOf:
            - type: string
            - type: 'null'
          description: Description returned by the Sendora API.
          title: Description
        event_types:
          description: Event types returned by the Sendora API.
          items:
            type: string
          title: Event Types
          type: array
        id:
          description: The endpoint's id. Pass it to any endpoint that takes `endpoint_id`.
          title: Id
          type: string
        is_active:
          description: Is active returned by the Sendora API.
          title: Is Active
          type: boolean
        url:
          description: Url returned by the Sendora API.
          title: Url
          type: string
      required:
        - id
        - url
        - event_types
        - is_active
        - created_at
      title: WebhookEndpointOut
      type: object
    HTTPValidationError:
      properties:
        detail:
          description: Detail returned by the Sendora API.
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      required: []
      title: HTTPValidationError
      type: object
    ValidationError:
      properties:
        loc:
          description: Loc returned by the Sendora API.
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          description: Msg returned by the Sendora API.
          title: Message
          type: string
        type:
          description: Type returned by the Sendora API.
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
  securitySchemes:
    ApiKeyAuth:
      description: Customer API key created in the Sendora dashboard.
      in: header
      name: X-API-Key
      type: apiKey

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.