Activity Type Metadata Resolver - API Contract

POST /api/v1/activity-types/api/v1/activity-types/metadata/resolve

Resolve and validate raw metadata JSON for an activity type

Public

Request Example

{
  "raw_metadata": "{\"category\":\"travel\",\"max_days\":\"30\",\"requires_receipt\":true}"
}

Response Example

{
  "resolved": {
    "category": "travel",
    "max_days": 30,
    "requires_receipt": true
  },
  "is_travel_expense_eligible": true,
  "requires_report_form": false,
  "triggers_reimbursement_workflow": true,
  "warnings": []
}

GET /api/v1/activity-types/api/v1/activity-types/:id/metadata/flags

Get computed behavioral flags for a specific activity type

Public

Response Example

{
  "activity_type_id": "at-001",
  "is_travel_expense_eligible": true,
  "requires_report_form": false,
  "triggers_reimbursement_workflow": true,
  "resolved_at": "2026-03-26T14:00:00Z"
}

Additional Metadata

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