# TenderUpdateWebhook

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths: {}
components:
  schemas:
    TenderChange:
      type: object
      required:
        - field_name
        - change_type
        - changed_at
      properties:
        field_name:
          type: string
          description: Name of the field that changed
          examples:
            - closing_date
        old_value:
          type: string
          description: Previous value (null for new fields)
          examples:
            - '2026-05-10T14:00:00Z'
          nullable: true
        new_value:
          type: string
          description: New value (null for deleted fields)
          examples:
            - '2026-05-15T14:00:00Z'
          nullable: true
        change_summary_ar:
          type: string
          description: Human-readable change summary in Arabic
          examples:
            - تم تمديد تاريخ الإغلاق من 2026-05-10 إلى 2026-05-15
        change_summary_en:
          type: string
          description: Human-readable change summary in English
          examples:
            - Closing date extended from 2026-05-10 to 2026-05-15
        change_type:
          type: string
          enum:
            - field_updated
            - field_added
            - field_removed
            - relation_added
            - relation_removed
          description: Type of change
          examples:
            - field_updated
        changed_at:
          type: string
          format: date-time
          description: ISO 8601 timestamp when this change occurred
          examples:
            - '2026-04-22T20:45:00Z'
        metadata:
          type: object
          description: Additional metadata about the change
          properties:
            field_label_ar:
              type: string
              examples:
                - تاريخ الإغلاق
            field_label_en:
              type: string
              examples:
                - Closing Date
          additionalProperties: true
          x-apidog-orders:
            - field_label_ar
            - field_label_en
          nullable: true
      x-apidog-orders:
        - field_name
        - old_value
        - new_value
        - change_summary_ar
        - change_summary_en
        - change_type
        - changed_at
        - metadata
      x-apidog-folder: ''
    Region:
      type: object
      properties:
        id:
          type: integer
          examples:
            - 3
        name:
          type: string
          examples:
            - Riyadh
      x-apidog-orders:
        - id
        - name
      x-apidog-folder: ''
    Category:
      type: object
      properties:
        id:
          type: integer
          examples:
            - 5
        name:
          type: string
          examples:
            - Construction
      x-apidog-orders:
        - id
        - name
      x-apidog-folder: ''
    Agency:
      type: object
      properties:
        id:
          type: integer
          examples:
            - 100
        name:
          type: string
          description: Agency name in Arabic
          examples:
            - وزارة البنية التحتية
        name_en:
          type: string
          description: Agency name in English
          examples:
            - Ministry of Infrastructure
      x-apidog-orders:
        - id
        - name
        - name_en
      x-apidog-folder: ''
    Tender:
      type: object
      description: >-
        Complete tender object with all details and relations. Fields included
        depend on your account API settings.
      properties:
        id:
          type: integer
          examples:
            - 45678
        referenceNumber:
          type: string
          examples:
            - RFP-2026-001
        tenderName:
          type: string
          description: Tender name in Arabic
          examples:
            - مشروع بناء
        tenderName_en:
          type: string
          description: Tender name in English
          examples:
            - Construction Project
        status:
          type: string
          enum:
            - active
            - closed
            - awarded
            - cancelled
          examples:
            - active
        submitted_at:
          type: string
          format: date-time
          examples:
            - '2026-04-15T10:00:00Z'
        closing_date:
          type: string
          format: date-time
          examples:
            - '2026-05-15T14:00:00Z'
        budget:
          type: number
          examples:
            - 1500000
          nullable: true
        currency:
          type: string
          examples:
            - SAR
          nullable: true
        description:
          type: string
          nullable: true
        agency:
          $ref: '#/components/schemas/Agency'
        category:
          $ref: '#/components/schemas/Category'
        region:
          $ref: '#/components/schemas/Region'
      x-apidog-orders:
        - id
        - referenceNumber
        - tenderName
        - tenderName_en
        - status
        - submitted_at
        - closing_date
        - budget
        - currency
        - description
        - agency
        - category
        - region
      x-apidog-folder: ''
    TenderUpdateWebhook:
      type: object
      required:
        - event
        - timestamp
        - account_id
        - tender
        - changes
      properties:
        event:
          type: string
          enum:
            - tender.updated
          description: Event type
          examples:
            - tender.updated
        timestamp:
          type: string
          format: date-time
          description: ISO 8601 timestamp when the webhook was generated
          examples:
            - '2026-04-22T20:52:00Z'
        account_id:
          type: integer
          description: Your TendersAlerts account ID
          examples:
            - 123
        tender:
          $ref: '#/components/schemas/Tender'
        changes:
          type: array
          description: Array of changes that occurred (batched updates)
          items:
            $ref: '#/components/schemas/TenderChange'
          minItems: 1
      x-apidog-orders:
        - event
        - timestamp
        - account_id
        - tender
        - changes
      x-apidog-folder: ''
  securitySchemes: {}
servers:
  - url: https://api.tendersalerts.com/api/integration
    description: Prod Env
security: []

```