Bufdir Export Edge Function - API Contract

POST /api/v1/bufdir-export-edge/api/v1/bufdir-export-edge/invoke

Invoke the edge function to orchestrate full export pipeline

Public

Request Example

{
  "org_id": "org_482",
  "scope_id": "scope_region_07",
  "scope_level": "region",
  "date_range": {
    "from": "2025-01-01",
    "to": "2025-12-31"
  },
  "format": "pdf",
  "preview": false
}

Response Example

{
  "report_id": "rpt_20250101_region07_pdf",
  "org_id": "org_482",
  "scope_id": "scope_region_07",
  "format": "pdf",
  "status": "complete",
  "download_url": "https://storage.example.no/exports/org_482/rpt_20250101_region07_pdf.pdf?token=tok_abc",
  "activity_count": 1247,
  "generated_at": "2026-03-26T10:18:00Z"
}

POST /api/v1/bufdir-export-edge/api/v1/bufdir-export-edge/preview

Invoke edge function in preview mode (no file written)

Public

Request Example

{
  "org_id": "org_482",
  "scope_id": "scope_region_07",
  "scope_level": "region",
  "date_range": {
    "from": "2025-01-01",
    "to": "2025-12-31"
  },
  "format": "pdf",
  "preview": true
}

Response Example

{
  "preview_id": "prev_9183",
  "org_id": "org_482",
  "scope_id": "scope_region_07",
  "scope_level": "region",
  "activity_count": 1247,
  "mentor_count": 83,
  "youth_count": 412,
  "unmapped_categories": [],
  "validation_warnings": [],
  "estimated_pdf_pages": 4,
  "generated_at": "2026-03-26T10:15:00Z"
}

Additional Metadata

{
  "contract_summary": {
    "total_contracts": 410,
    "total_endpoints": 2416,
    "api_styles_used": [
      "rest"
    ]
  },
  "generated_at": "2026-03-26T06:55:53.316Z"
}