{
  "task_id": "task_create_api_referrals_create",
  "entity_id": "api_referrals_create",
  "generated_at": "2025-12-18T01:57:52.723352",
  "workflow_version": "v001",
  "target": {
    "type": "api",
    "definition": {
      "id": "api_referrals_create",
      "path": "/api/referrals",
      "method": "POST",
      "description": "Create referral code",
      "file_path": "app/api/referrals/route.ts",
      "status": "PENDING",
      "auth_required": true,
      "responses": [
        {
          "status": 200,
          "description": "Success",
          "schema": {
            "referral_code": "string",
            "referral_url": "string"
          }
        }
      ]
    }
  },
  "related": {
    "models": [],
    "apis": [],
    "components": []
  },
  "dependencies": {
    "entity_ids": [],
    "definitions": []
  },
  "files": {
    "to_create": [
      "app/api/referrals/route.ts"
    ],
    "reference": []
  },
  "acceptance": [
    {
      "criterion": "POST /api/referrals returns success response",
      "verification": "curl -X POST /api/referrals"
    },
    {
      "criterion": "Request validation implemented",
      "verification": "Test with invalid data"
    },
    {
      "criterion": "Error responses match contract",
      "verification": "Test error scenarios"
    }
  ]
}