Retrieve calendar / Gantt feed data (CALENDAR, STORE_PROJECTS, STORE_WALK_CAL)

GET /task/v1/calendar

Operation id: getCalendarData

Description

Retrieves calendar or Gantt feed data for the authenticated user. Corresponds to legacy: POST /service/rtm/getCalendarData.

Source Types

Session-Derived Parameters (Always Injected — Not Overridable)

Session-Defaulted Parameters (Client Can Override)

selected_dates is not a request parameter — it is derived server-side by iterating all dates between from_date and to_date in yyyyMMdd format.

p_ Prefix Parameters

The p_ prefixed params use a non-standard mixed-case mapping (p_sort_column_1 → p_SortColumn1) used in the downstream template substitution. They cannot be produced by standard camelCase conversion and are mapped explicitly.

System Filter / RAR Handling

When filter_id is present and parseable, FilterService.getSystemFilter() loads MwFilterConfig. Three paths follow:

• RAR source + filter → setRARParameters() injects filter params, calLayout overridden from filter.
• Non-RAR filter with router → ServiceRouterUtil.authenticateAndExecute() routes externally.
• No filter → RTMUpdateService.getCalendarData() called directly with template substitution.

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, calendar_data: {...}}.

Response shape depends on source_id:

• CALENDAR → calendar_data.feed_details[] (full feed records, 40+ fields) + last_fetch_time
• STORE_PROJECTS / STORE_SUGGESTED_DATE_PROJECTS → calendar_data.project_data[] Each item: project_id, project_title, project_type, project_type_desc, icon, start_date, end_date, priority, is_overdue, is_completed, is_confidential, is_edited, has_survey, has_attachment, assigned_role
• STORE_WALK_CAL → calendar_data.project_data[] Each item: project_id, project_title, project_type, assigned_to, start_date, end_date
• No data → {status: ER, error_code: E404, response: "No data found"}

Content type: application/json

400 — E140 — source_id is mandatory.

E142 — from_date is mandatory. E143 — to_date is mandatory. E147 — from_date must not be after to_date.

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, calendar_data: {...}}.

Response shape depends on source_id:

• CALENDAR → calendar_data.feed_details[] (full feed records, 40+ fields) + last_fetch_time
• STORE_PROJECTS / STORE_SUGGESTED_DATE_PROJECTS → calendar_data.project_data[] Each item: project_id, project_title, project_type, project_type_desc, icon, start_date, end_date, priority, is_overdue, is_completed, is_confidential, is_edited, has_survey, has_attachment, assigned_role
• STORE_WALK_CAL → calendar_data.project_data[] Each item: project_id, project_title, project_type, assigned_to, start_date, end_date
• No data → {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",
  "calendar_data": {
    "feed_details": [
      {
        "feed_key": 45810367,
        "feed_title": "HO%20Violation%20Project",
        "feed_type": "T",
        "feed_type_id": "V12",
        "status": "O",
        "priority": 1,
        "start_date_time": "2026-03-31 00:00:00",
        "end_date_time": "2026-03-31 23:59:59",
        "cluster_id": "4293672"
      }
    ],
    "last_fetch_time": 1775827383742
  }
}

400 — E140 — source_id is mandatory.

E142 — from_date is mandatory. E143 — to_date is mandatory. E147 — from_date must not be after to_date.

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"
}