labelixa-com Webhooks API

openapi: 3.2.0
info:
  title: Labelixa Com Webhooks API
  version: 0.4.0
  description: 'Operations tagged Webhooks across 2 of this provider''s published API definitions: labelixa-com-api-openapi.json, labelixa-com-openapi.json. Each path carries the servers of the definition it was published in.'
tags:
- name: Webhooks
paths:
  /v1/webhooks:
    get:
      summary: List webhook endpoints
      operationId: webhook_listesi_v1_webhooks_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      description: Lists the account's webhook endpoints (without secrets), including whether each is active, its last status code and any remaining secret-rotation window.
      tags:
      - Webhooks
    post:
      summary: Register webhook endpoint
      description: Registers an outgoing webhook endpoint (Professional, Business and Enterprise plans). The signing secret is returned in this response only and never shown again in listings. The target URL is validated here and rejected with 400 if unacceptable. 201 on success.
      operationId: webhook_ekle_v1_webhooks_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WebhookIstegi'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Webhooks
  /v1/webhooks/{uc_id}/rotate:
    post:
      summary: Rotate webhook secret
      description: Generates a new signing secret. The old secret stays valid for a transition window and deliveries carry two signatures during it, so the receiver can switch without downtime. The new secret is returned in this response only. Someone else's resource and a non-existent one return the same 404.
      operationId: webhook_sir_yenile_v1_webhooks__uc_id__rotate_post
      parameters:
      - name: uc_id
        in: path
        required: true
        schema:
          type: string
          title: Uc Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Webhooks
  /v1/webhooks/{uc_id}:
    delete:
      summary: Delete webhook endpoint
      description: Deletes a webhook endpoint. Someone else's resource and a non-existent one return the same 404.
      operationId: webhook_sil_v1_webhooks__uc_id__delete
      parameters:
      - name: uc_id
        in: path
        required: true
        schema:
          type: string
          title: Uc Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Webhooks
  /v1/webhooks/stripe:
    post:
      summary: Stripe webhook receiver
      description: Receives Stripe subscription events (start, update, cancel). Nothing happens unless the `Stripe-Signature` verifies (400 otherwise). Repeated deliveries of a completed event return 200 without reprocessing.
      operationId: stripe_webhook_v1_webhooks_stripe_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - Webhooks
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    WebhookIstegi:
      properties:
        url:
          type: string
          title: Url
        olaylar:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Olaylar
      type: object
      required:
      - url
      title: WebhookIstegi
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
x-refined-from:
- labelixa-com-api-openapi.json
- labelixa-com-openapi.json