Retrieve leadership calendar project data (monthly or annual view)

GET /task/v1/calendar/leadership

Operation id: getLeadershipCalendarData

Description

Retrieves leadership calendar project data for Monthly (M) or Annual (A) views. Corresponds to legacy: POST /service/execute/getLeadershipCalendarData.

Always-injected from session: domainId and authToken are resolved and injected. ServiceRouterUtil also auto-injects pulseAuthToken from authToken if absent.

Typed value parsing: Since GET query params are strings, the service layer parses:

• Comma-separated arrays → typed List (e.g. exec_level=1,2 → List<Integer>)
• show_only_my_projects, show_field_projects → parsed to Boolean
• month_no, year → parsed to Integer

Note on absent boolean params: The legacy frontend sets these from filter state that can be undefined. When undefined, the key is simply absent. The headless API handles absent keys gracefully — they are not included in the param map.

Response Fields — leadership_data

Error Scenarios

Error Codes Reference

Tags: MyWorkCalendar

Parameters

Query parameters

Security

• AuthTokenHeader (apiKey)
  • Session authentication token validated server-side against the user session store.

Responses

200 — Success — {status: OK, leadership_data: {...}}.

No data (service exception) → {status: ER, error_code: E404, response: "No data found"}.

Content type: application/json

400 — E144 — cal_type is mandatory.

E145 — month_no is mandatory. E146 — year is mandatory.

Content type: application/json

401 — Missing or invalid X-reflexis-csrf-token-X session token

Content type: application/json

500 — Unexpected server-side error

Content type: application/json

Response models

200 — Success — {status: OK, leadership_data: {...}}.

No data (service exception) → {status: ER, error_code: E404, response: "No data found"}.

Content type: application/json

Schema

JSON object (structure varies by endpoint).

{
  "type": "object",
  "description": "JSON object (structure varies by endpoint)."
}

Example:

{
  "status": "OK",
  "leadership_data": {
    "leadership_calender_project_data": [
      {
        "project_id": "4290692",
        "project_title": "Q1 Store Refresh",
        "project_type": "310",
        "start_date": 20260401,
        "end_date": 20260407,
        "span": "START_END_DATE",
        "priority": 2,
        "legend_id": "LEGEND_1"
      }
    ],
    "leadership_categories": [
      {
        "id": "CAT_1",
        "name": "Operations"
      }
    ],
    "leadership_admin_legend_details": [
      {
        "id": "LEGEND_1",
        "name": "High Priority",
        "color": "#FF0000"
      }
    ],
    "notes": {},
    "monthly_notes": {}
  }
}

400 — E144 — cal_type is mandatory.

E145 — month_no is mandatory. E146 — year is mandatory.

Content type: application/json

Schema

{
  "type": "object",
  "example": {
    "status": "ER",
    "errorCode": "E202",
    "response": "User session is invalid"
  },
  "required": [
    "status",
    "errorCode",
    "response"
  ],
  "properties": {
    "status": {
      "type": "string",
      "description": "Always \"ER\" for error responses",
      "enum": [
        "ER"
      ]
    },
    "errorCode": {
      "type": "string",
      "description": "Application-level error code (e.g. E202, E105, E404)"
    },
    "response": {
      "type": "string",
      "description": "Human-readable error message"
    }
  }
}

401 — Missing or invalid X-reflexis-csrf-token-X session token

Content type: application/json

Schema

{
  "type": "object",
  "example": {
    "status": "ER",
    "errorCode": "E202",
    "response": "User session is invalid"
  },
  "required": [
    "status",
    "errorCode",
    "response"
  ],
  "properties": {
    "status": {
      "type": "string",
      "description": "Always \"ER\" for error responses",
      "enum": [
        "ER"
      ]
    },
    "errorCode": {
      "type": "string",
      "description": "Application-level error code (e.g. E202, E105, E404)"
    },
    "response": {
      "type": "string",
      "description": "Human-readable error message"
    }
  }
}

Example:

{
  "status": "ER",
  "errorCode": "E202",
  "response": "User session is invalid"
}

500 — Unexpected server-side error

Content type: application/json

Schema

{
  "type": "object",
  "example": {
    "status": "ER",
    "errorCode": "E202",
    "response": "User session is invalid"
  },
  "required": [
    "status",
    "errorCode",
    "response"
  ],
  "properties": {
    "status": {
      "type": "string",
      "description": "Always \"ER\" for error responses",
      "enum": [
        "ER"
      ]
    },
    "errorCode": {
      "type": "string",
      "description": "Application-level error code (e.g. E202, E105, E404)"
    },
    "response": {
      "type": "string",
      "description": "Human-readable error message"
    }
  }
}

Example:

{
  "status": "ER",
  "errorCode": "E302",
  "response": "Internal server error"
}