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

# Handle Livekit Webhook

> Handle webhooks from LiveKit server.

LiveKit sends webhooks for various events:
- room_started: When a room is created
- room_finished: When a room is closed
- participant_joined: When someone joins
- participant_left: When someone leaves
- egress_started: When recording starts
- egress_ended: When recording finishes

Security: Webhook signature verification is REQUIRED.
The Authorization header must contain a valid JWT signed with LIVEKIT_API_SECRET.

See: https://docs.livekit.io/home/server/webhooks/



## OpenAPI

````yaml /api-reference/openapi-filtered.json post /api/webhooks/livekit
openapi: 3.1.0
info:
  title: Aseed Insight API
  version: 0.1.0
servers:
  - url: https://app.aseed.ai/custdev
security: []
tags:
  - name: insight
    description: 'Core insight endpoints: records, transcripts, generation, and chat.'
    x-displayName: Insight
  - name: insight_public
    description: Public insight endpoints for shared/public access.
    x-displayName: Insight Public
  - name: projects
    description: Project management endpoints.
    x-displayName: Projects
  - name: project_reports
    description: Project report generation and management endpoints.
    x-displayName: Project Reports
  - name: project_reports_public
    description: Public project report endpoints.
    x-displayName: Project Reports Public
  - name: prompts
    description: Custom prompts management endpoints.
    x-displayName: Prompts
  - name: presets
    description: Presets and templates endpoints.
    x-displayName: Presets
  - name: agent
    description: AI agent threads and chat endpoints.
    x-displayName: Agent
  - name: interviews
    description: AI interviewer room and session endpoints.
    x-displayName: Interviews
  - name: webhooks
    description: Incoming webhook endpoints.
    x-displayName: Webhooks
paths:
  /api/webhooks/livekit:
    post:
      tags:
        - webhooks
      summary: Handle Livekit Webhook
      description: >-
        Handle webhooks from LiveKit server.


        LiveKit sends webhooks for various events:

        - room_started: When a room is created

        - room_finished: When a room is closed

        - participant_joined: When someone joins

        - participant_left: When someone leaves

        - egress_started: When recording starts

        - egress_ended: When recording finishes


        Security: Webhook signature verification is REQUIRED.

        The Authorization header must contain a valid JWT signed with
        LIVEKIT_API_SECRET.


        See: https://docs.livekit.io/home/server/webhooks/
      operationId: handle_livekit_webhook_api_webhooks_livekit_post
      parameters:
        - name: Authorization
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````