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

# Get webhook configuration for an application

> Retrieves the webhook configuration for the current application. Returns null if no webhook is configured.



## OpenAPI

````yaml https://app.stainless.com/api/spec/documented/avido/openapi.documented.yml get /v0/webhook
openapi: 3.1.1
info:
  title: Avido API
  description: >-
    Avido's API for LLM usage events, tool calls, trace management, webhook
    validation, and more. See each endpoint's request/response schema for
    details.
  version: 0.1.0
  contact:
    name: Avido Support
    email: support@avidoai.com
    url: https://avidoai.com/support
servers:
  - url: https://api.avidoai.com
    description: Production API
security:
  - ApiKey: []
    ApplicationId: []
paths:
  /v0/webhook:
    get:
      tags:
        - Webhook
      summary: Get webhook configuration for an application
      description: >-
        Retrieves the webhook configuration for the current application. Returns
        null if no webhook is configured.
      operationId: getWebhook
      responses:
        '200':
          description: Webhook configuration retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WebhookResponse'
        '400':
          description: bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Application not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: invalid input
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationErrorResponse'
        '500':
          description: internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    WebhookResponse:
      type: object
      properties:
        data:
          anyOf:
            - type: object
              properties:
                id:
                  type: string
                  description: The unique identifier for the webhook
                  example: 123e4567-e89b-12d3-a456-426614174000
                url:
                  type: string
                  description: The URL where webhook events will be sent.
                  example: https://example.com/webhook
                webhookSecret:
                  type: string
                  description: The secret used to sign webhook payloads
                  example: whsec_1234567890abcdef
                applicationId:
                  type: string
                  description: The ID of the application this webhook belongs to
                  example: 123e4567-e89b-12d3-a456-426614174000
                headers:
                  description: Custom authentication headers to include in webhook requests
                  anyOf:
                    - $ref: '#/components/schemas/WebhookHeaders'
                    - type: 'null'
                createdAt:
                  description: When the webhook was created
                  example: '2024-01-01T00:00:00.000Z'
                  type: string
                  format: date-time
                  pattern: >-
                    ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
                modifiedAt:
                  description: When the webhook was last modified
                  example: '2024-01-01T00:00:00.000Z'
                  type: string
                  format: date-time
                  pattern: >-
                    ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
                orgId:
                  type: string
                  description: The organization ID this webhook belongs to
                  example: 123e4567-e89b-12d3-a456-426614174000
              required:
                - id
                - url
                - webhookSecret
                - applicationId
                - createdAt
                - modifiedAt
                - orgId
              additionalProperties: false
              title: Webhook
              description: Webhook configuration for an application
            - type: 'null'
          description: The webhook configuration, or null if no webhook is configured
      required:
        - data
      additionalProperties: false
      title: WebhookResponse
      description: Response containing a webhook configuration or null
    ErrorResponse:
      type: object
      properties:
        message:
          type: string
          description: A human-readable error message explaining the error.
          example: Resource not found
      required:
        - message
      additionalProperties: false
      title: ErrorResponse
      description: Standard error format for failed API operations.
    ValidationErrorResponse:
      type: object
      properties:
        message:
          type: string
          description: A human-readable error message indicating what went wrong.
          example: Invalid request data
        issues:
          type: array
          items:
            type: object
            properties:
              code:
                type: string
              message:
                type: string
              path:
                type: array
                items:
                  type: string
            required:
              - code
              - message
              - path
            additionalProperties: false
          description: Array of detailed validation error objects.
          example:
            - code: invalid_string
              message: Invalid UUID
              path:
                - id
      required:
        - message
        - issues
      additionalProperties: false
      title: ValidationErrorResponse
      description: Details about validation errors in incoming requests.
    WebhookHeaders:
      type: object
      propertyNames:
        type: string
        minLength: 1
        maxLength: 256
        pattern: ^[^\r\n]*$
      additionalProperties:
        type: string
        minLength: 1
        maxLength: 2048
        pattern: ^[^\r\n]*$
      title: WebhookHeaders
      description: >-
        Custom headers to include in webhook requests. Keys are header names,
        values are header values. Maximum 20 headers per webhook.
      example:
        Authorization: Bearer my-secret-token
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: Your unique Avido API key
    ApplicationId:
      type: apiKey
      in: header
      name: x-application-id
      description: Your unique Avido Application ID

````