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

# Update Webhook Endpoint

> Update an existing webhook endpoint.
You can modify its description, event subscriptions, or status (active, paused, disabled).



## OpenAPI

````yaml https://raw.githubusercontent.com/vidinfra/open-api-docs/refs/heads/main/openapi.json put /libraries/{libraryId}/webhooks/endpoints/{endpointId}
openapi: 3.0.1
info:
  title: Default module
  description: ''
  version: 1.0.0
servers:
  - url: https://api.tenbyte.io/v1/vidinfra
    description: Production server
security:
  - bearer: []
tags:
  - name: Library
  - name: Folder
  - name: Video
  - name: Subtitle
  - name: Video Thumbnails
  - name: Transcoding Profiles
  - name: Player Themes
  - name: Video Chapter
  - name: Webhook Endpoints
  - name: Webhook Deliveries
  - name: Security
  - name: Video Multipart Upload
  - name: Webhook
  - name: Migration Jobs
paths:
  /libraries/{libraryId}/webhooks/endpoints/{endpointId}:
    put:
      tags:
        - Webhook Endpoints
      summary: Update Webhook Endpoint
      description: >-
        Update an existing webhook endpoint.

        You can modify its description, event subscriptions, or status (active,
        paused, disabled).
      parameters:
        - name: libraryId
          in: path
          description: Unique identifier of the library.
          required: true
          example: 314221a1-3cbf-4d3c-846e-f6c22bc43064
          schema:
            type: string
        - name: endpointId
          in: path
          description: Unique identifier of the targeted endpoint resource.
          required: true
          example: a7f590b4-3fd7-42a4-82bb-a7cfa6aa9d04
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                url:
                  type: string
                  description: The destination URL where webhook events will be sent.
                name:
                  type: string
                  description: >-
                    A descriptive name for the webhook endpoint, used for
                    identification.
                events:
                  type: array
                  items:
                    type: string
                  description: >-
                    List of event types that will trigger this webhook (e.g.,
                    'video.created', 'transcoding.completed').
                secret:
                  type: string
                  description: >-
                    Optional secret key used to sign webhook payloads for
                    verification and security.
              required:
                - url
                - name
                - events
            example:
              url: https://example.com/webhooks/tenbyte
              name: Video processing events
              events:
                - uploaded
                - downloading
              secret: auto-generate
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      updated_at:
                        type: string
                      created_at:
                        type: string
                      library_id:
                        type: string
                      updated_by:
                        type: string
                      created_by:
                        type: string
                      headers:
                        type: string
                      name:
                        type: string
                      url:
                        type: string
                      events:
                        type: array
                        items:
                          type: string
                      id:
                        type: string
                      organization_id:
                        type: string
                      is_active:
                        type: boolean
                    required:
                      - updated_at
                      - created_at
                      - library_id
                      - updated_by
                      - created_by
                      - headers
                      - name
                      - url
                      - events
                      - id
                      - organization_id
                      - is_active
                  message:
                    type: string
                  success:
                    type: boolean
                required:
                  - data
                  - message
                  - success
              example:
                data:
                  updated_at: '2025-10-15T13:18:25.690910108+06:00'
                  created_at: '2025-10-15T13:06:54.816373+06:00'
                  library_id: 78542c6f-0dc1-4859-a122-35ad6f139827
                  updated_by: 2fa3fe27-ffcd-470b-becf-83f6f22a93ab
                  created_by: 2fa3fe27-ffcd-470b-becf-83f6f22a93ab
                  headers: null
                  name: Video processing events
                  url: https://example.com/webhooks/vidinfra
                  events:
                    - uploaded
                    - transcoded
                  id: 8e5f8558-50dc-453f-9c36-4e4e9033b36a
                  organization_id: 677826f5-1aea-4cba-8973-043cdbc60f35
                  is_active: true
                message: Webhook Endpoint Updated Successfully
                success: true
          headers: {}
        '400':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  success:
                    type: boolean
                required:
                  - message
                  - success
              example:
                message: Invalid Request
                success: false
          headers: {}
        '401':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                  message:
                    type: string
                  success:
                    type: boolean
                required:
                  - code
                  - message
                  - success
              example:
                code: auth_type_not_found
                message: >-
                  Could not determine authentication type from request. Please
                  provide a valid Authorization header or X-API-Key header.
                success: false
          headers: {}
        '404':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  success:
                    type: boolean
                required:
                  - message
                  - success
              example:
                message: Resource not found
                success: false
          headers: {}
        '422':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                        code:
                          type: string
                        message:
                          type: string
                  success:
                    type: boolean
                required:
                  - message
                  - errors
                  - success
              example:
                message: Invalid Request
                errors:
                  - field: field_name
                    code: validation_required
                    message: This field is required
                success: false
          headers: {}
        '500':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  success:
                    type: boolean
                required:
                  - message
                  - success
              example:
                message: Internal server error
                success: false
          headers: {}
      deprecated: false
      security:
        - bearer: []
components:
  securitySchemes:
    bearer:
      type: http
      scheme: bearer

````