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

# List webhook endpoints

> List your registered webhook endpoints with their subscribed
event types.



## OpenAPI

````yaml https://roughy-api-staging.fly.dev/v1/openapi.json get /v1/webhook-endpoints
openapi: 3.1.0
info:
  title: Roughy Public API
  version: 0.0.0
servers:
  - url: https://roughy-api-staging.fly.dev
    description: Staging
security: []
tags:
  - name: Projects
    description: >-
      Workflow containers. Every asset lives inside a project; a project groups
      everything for one piece of work (an episode, an interview, a talk).
  - name: Assets
    description: >-
      The unit of media. `POST /assets` creates one and opens its upload in a
      single call: the response body is the asset (its `upload_url` carries the
      transfer URL while `pending_upload`), and the TUS transfer URL also comes
      back in the `Location` header. List, detail (with signed download URL),
      and delete round it out. Each asset belongs to exactly one project;
      `language` is set at create and immutable.
  - name: Uploads
    description: >-
      Drive the TUS-resumable transfer that streams an asset's bytes. `POST
      /assets` opens the upload; `PATCH`/`HEAD` move and resume the bytes,
      `DELETE` cancels (removing the asset). Lost the transfer URL? Re-`GET` the
      asset — while it's `pending_upload`, `upload_url` carries it.
  - name: Cuts
    description: >-
      A kept-segment plan for an asset, computed automatically by Roughy. Create
      one with `POST /cuts {asset_id, script?}`, list with `GET /cuts`, read a
      cut, export it to NLE formats, and export its generated subtitle (SRT /
      VTT).
  - name: Renders
    description: >-
      Renders an asset to a video (`mp4`/`mov`) or audio (`m4a`/`mp3`) output,
      optionally applying a `cut_id`. `POST /renders {asset_id, cut_id?,
      output}` creates one; list, read (with a signed download URL), and cancel
      as a top-level `/renders` resource.
  - name: Webhooks
    description: >-
      Register endpoints to receive signed terminal-state events (cut / render /
      asset) instead of polling.
  - name: Credits
    description: Credit balance and usage history.
  - name: Users
    description: Your account and profile.
  - name: OAuth
    description: >-
      Device authorization grant (RFC 8628), served at app.roughy.ai/oauth/* for
      the editor plugin. Internal surface — not part of the public /v1 SDK.
  - name: billing
    description: Stripe customer portal, invoices, subscriptions.
  - name: api-keys
    description: Mint and revoke API keys.
  - name: auth
    description: Sign up, log in, log out, and OAuth flows for the dashboard.
  - name: webhooks
    description: Inbound provider webhooks (Stripe, Resend, ElevenLabs).
  - name: email-preferences
    description: Per-category transactional-email opt-out preferences.
  - name: sse
    description: Server-sent live updates per asset.
  - name: health
    description: Liveness and readiness probes.
paths:
  /v1/webhook-endpoints:
    get:
      tags:
        - Webhooks
      summary: List webhook endpoints
      description: |-
        List your registered webhook endpoints with their subscribed
        event types.
      operationId: list_endpoints_v1_webhook_endpoints_get
      responses:
        '200':
          description: Your webhook endpoints.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WebhookEndpointListResponse'
      security:
        - HTTPBearer: []
components:
  schemas:
    WebhookEndpointListResponse:
      properties:
        items:
          items:
            $ref: '#/components/schemas/WebhookEndpointResponse'
          type: array
          title: Items
          description: Your webhook endpoints.
      type: object
      required:
        - items
      title: WebhookEndpointListResponse
    WebhookEndpointResponse:
      properties:
        id:
          type: string
          title: Id
          description: Webhook endpoint id.
        url:
          type: string
          title: Url
          description: The endpoint's delivery URL.
        event_types:
          items:
            type: string
          type: array
          title: Event Types
          description: The event types this endpoint is subscribed to.
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
          description: The endpoint's human label, if set.
      type: object
      required:
        - id
        - url
        - event_types
      title: WebhookEndpointResponse
  securitySchemes:
    HTTPBearer:
      type: http
      description: >-
        Pass your API key as `Authorization: Bearer sk_…`. Mint a key from your
        dashboard's API-keys page.
      scheme: bearer
      bearerFormat: sk_…

````