Task-view feeds with cursor pagination (forces task_view=TV)

GET /task/v1/feeds/list/tasks

Operation id: retrieveFeedsTasks

Description

Retrieves a paginated list of feeds at task row granularity. Identical filters and handler as retrieve-type=list, but the server forces task_view=TV before processing.

view_type (MV / SV / DV, default MV) is still accepted and controls line-of-sight scope. Do not confuse view_type with task_view — they are orthogonal.

Supports cursor-based pagination (same rules as /feeds/list), sorting, projections, requested-unit / requested-user (RU) identity (v_request_type=ru), and all standard feed filters. See /task/v1/feeds/{retrieve-type} for full RU identity rules and session update table.

Cursor-Based Pagination

  1. Initial: GET /task/v1/feeds/list/tasks?status=N&limit=20
  2. Next page: add starting_after=<next_cursor from response>
  3. Prev page: add ending_before=<previous_cursor from response>
  4. Use only one of starting_after / ending_before per request (both → E206)
  5. limit clamped to 1–100 (below 1 defaults to 20, above 100 caps at 100)

Projections — Default Fields

When projections is omitted, the following fields are returned per feed object:

feed_key, feed_title, message_type, status, priority, feed_type, feed_type_id, cluster_id, cluster_child_id, start_date_time, end_date_time, display_launch_date, create_dtm, last_updated_time, task_count, overdue_task_count, pin, pinned, favorite_flag, acknowledged_flag, is_confidential, has_survey, title_css, panel_config, assign_to_desc, has_comments, enable_comment, future_feed, show_why_url, has_action, enable_action, show_how_url, has_history, has_user_notes, has_actions, has_contents, has_key_attributes, project_title, parent_feed_key, last_action_time, last_action_time_in_millis

Note: project_title and parent_feed_key are only present on Task records (cluster_child_id != -1). Project-without-task records (cluster_child_id = -1) do not carry these fields. Boolean pinned is stamped when TASK_PIN_COUNT > 0.

Projections — Additional Available Fields

transaction_key, feed_owner, feed_type_id_desc, ext_link_info, dept_id, end_date_utc, display_start_date, profile_id, display_date, has_predecessor, show_acknowledge, last_updated_time_in_millis, event_date, additional_attributes, show_claim, promote_to_note_flag, update_all_mul_asg_task_attr, flag, is_edited, allow_future_quick_links, thread_flag, acknowledge_flag, txn_dtm, lock_status, start_date_utc, unit_id, action_taken_flag, time_to_act, feed_description, feed_params, event_end_date, watch_flag, follow, user_id, feed_task_count, display_end_date


Error Scenarios

ScenarioHTTPError CodeMessage
Missing X-reflexis-csrf-token-X header400E112X-reflexis-csrf-token-X header is mandatory
Invalid or expired token401E204Invalid or expired token
Both starting_after and ending_before400E206Cannot use both starting_after and ending_before simultaneously.
RU: missing v_requested_unit_id400E107Unit id is mandatory
RU: MV/DV without v_requested_user_id400E113v_requested_user_id is mandatory
RU: user not in v_requested_unit_id400E178Requested user does not belong to the provided unit
RU: invalid v_requested_profile_id400E179Invalid v_requested_profile_id for the requested user
RU: invalid v_requested_dept_id400E180Invalid v_requested_dept_id for the requested user
RU: requested user not found200E404No data found
No data found200E404No data found

Error Codes Reference

CodeDescription
E112X-reflexis-csrf-token-X header is mandatory
E206Both pagination cursors provided simultaneously
E107RU: missing or invalid v_requested_unit_id
E113RU: mandatory parameter missing (typically v_requested_user_id for MV/DV)
E178RU: requested user does not belong to the provided unit
E179RU: invalid v_requested_profile_id for the user
E180RU: invalid v_requested_dept_id for the user
E204Invalid or expired token
E404No data found (includes RU kernel user lookup failure)

Tags: MyWorkFeeds

Parameters

Query parameters

NameTypeRequiredDescription
acknowledge_flagintegerNoAcknowledge filter: -1=all, 0=not acknowledged, 1=acknowledged
com_attr_valstringNoCommunication attribute value filter
cut_off_timeinteger (int64)NoCut-off time in epoch ms
ending_beforestringNoBackward pagination cursor (use previous_cursor from previous response)
favoriteintegerNoFavorite filter: -1=all, 0=not favorite, 1=favorite
feed_titlestringNoText search on feed title (URL-encoded, auto-decoded)
feed_type_idstringNoFeed type ID filter
filter_idstringNoSystem filter ID. When provided, loads MwFilterConfig and uses it for data retrieval. The client-supplied limit is honoured and overrides the filter's stored PAGINATION_LIMIT.
followintegerNoFollow filter: -1=all
limitintegerNoMax records per page (clamped to 1-100)
message_typestringNoFeed message type code
msg_attr_valstringNoMessage attribute value filter
pinintegerNoPin filter: -1=all, 0=not pinned, 1=pinned
prioritystringNoComma-separated priority integers
projectionsstringNoComma-separated field names to include in each feed object
promote_to_note_flagintegerNoPromote-to-note filter
return_formatstringNoReturn format: J=JSON
return_typestringNoReturn type filter
selected_datesstringNoComma-separated dates in YYYYMMDD format
sort_bystringNoComma-separated sort columns
sort_orderstringNoComma-separated sort directions: A=ascending, D=descending
starting_afterstringNoForward pagination cursor (use next_cursor from previous response)
statusstringNoComma-separated status codes: N, R, P, O, C, F, E
tagsstringNoTags filter
task_viewstringNoServer-forced to TV. Client-supplied values are overwritten before processing. Row granularity only — use view_type for line-of-sight.
v_request_typestringNoRequested-unit / requested-user (corp) identity mode for feed retrieve endpoints. Case-insensitive ru activates in-memory overrides of unitId, userId, profileId, and deptId on the authenticated session before feed processing. Omitted → store-user token session. Any other value is ignored (no error; session unchanged). Applied to list, list-latest, and /list/tasks. Not applied when retrieve-type=count.
v_requested_dept_idstringNoOptional comma-separated department subset for the requested user (RU + user path). Each value must belong to the user's kernel departments → E180. When omitted, backfilled from kernel (deptIds / deptId); sentinel -1 if none.
v_requested_profile_idstringNoOptional comma-separated profile subset for the requested user (RU + user path). Each value must belong to the user's kernel profiles → E179. When omitted, backfilled from kernel (profileIds / profileId); sentinel -1 if none.
v_requested_unit_idstringNoTarget store unit ID for RU mode. Required when v_request_type=ru. Missing or -1 → E107.
v_requested_user_idstringNoImpersonated store user for RU mode. Required when view_type is MV or DV (including default MV). Optional for SV — omit for store-wide view. Omitted or -1 is treated as absent. MV/DV without user → E113. SV without user: confidential feeds are not returned; supply a user id to evaluate confidential visibility for that user.
view_typestringNoLine-of-sight scope: MV=My View, DV=Department View, SV=Store View. Independent of task_view (forced to TV on this endpoint). Drives RU validation rules.
week_datesstringNoComma-separated week dates in YYYYMMDD format (e.g. 20260322,20260323,...,20260328). Filters the feed list to the specified date range on both the standard and system-filter query paths.

Security

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

Responses

200 — Success — {feed_details[], previous_cursor, next_cursor, has_more, last_fetch_time}

list response fields:

FieldTypeDescription
feed_details[]ArrayFeed objects (fields controlled by projections)
has_moreBooleantrue if more records available after current page
next_cursorStringOpaque cursor for next page — use with starting_after. null if no more pages.
previous_cursorStringOpaque cursor for previous page — use with ending_before. null if on first page.
last_fetch_timeLongEpoch ms when data was fetched

count response fields:

FieldTypeDescription
count_data.priorities[]ArrayEach: name (priority), id, value (count as String)
count_data.totalIntegerTotal count across all priorities

list-latest response fields:

FieldTypeDescription
feed_list_latest[]ArrayFeed objects changed/added since from_time
statusStringOK on success

Content type: application/json

400 — E205 — Invalid retrieve-type (allowed: list, count, list-latest).

E206 — Both starting_after and ending_before provided simultaneously. E114 — start_date required for count. E115 — end_date required for count. E116 — Refresh interval exceeded for list-latest. E107 — RU missing v_requested_unit_id. E113 — RU MV/DV missing v_requested_user_id. E178 — RU user not in requested unit. E179 — RU invalid v_requested_profile_id. E180 — RU invalid v_requested_dept_id.

Content type: application/json

401 — Invalid or expired X-reflexis-csrf-token-X token (HTTP 401)

Content type: application/json

500 — Unexpected server-side error

Content type: application/json

Response models

200 — Success — {feed_details[], previous_cursor, next_cursor, has_more, last_fetch_time}

list response fields:

FieldTypeDescription
feed_details[]ArrayFeed objects (fields controlled by projections)
has_moreBooleantrue if more records available after current page
next_cursorStringOpaque cursor for next page — use with starting_after. null if no more pages.
previous_cursorStringOpaque cursor for previous page — use with ending_before. null if on first page.
last_fetch_timeLongEpoch ms when data was fetched

count response fields:

FieldTypeDescription
count_data.priorities[]ArrayEach: name (priority), id, value (count as String)
count_data.totalIntegerTotal count across all priorities

list-latest response fields:

FieldTypeDescription
feed_list_latest[]ArrayFeed objects changed/added since from_time
statusStringOK on success

Content type: application/json

Schema

JSON object (structure varies by endpoint).

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

Example:

{
  "status": "OK",
  "feed_details": [
    {
      "feed_key": 44814719,
      "feed_title": "Your%20request%20for%20download",
      "status": "R",
      "priority": 1,
      "message_type": "DOWNLOADFILEMSG",
      "cluster_id": "SYSADMIN_1773851291103",
      "cluster_child_id": "-1",
      "start_date_time": "2026-03-18 11:28:13",
      "end_date_time": "2026-03-25 11:28:08",
      "pin": 0,
      "favorite_flag": false,
      "has_survey": false,
      "enable_action": true
    }
  ],
  "previous_cursor": null,
  "next_cursor": "eyJza2lwIjoyMH0=",
  "has_more": true,
  "last_fetch_time": 1774373200310
}

400 — E205 — Invalid retrieve-type (allowed: list, count, list-latest).

E206 — Both starting_after and ending_before provided simultaneously. E114 — start_date required for count. E115 — end_date required for count. E116 — Refresh interval exceeded for list-latest. E107 — RU missing v_requested_unit_id. E113 — RU MV/DV missing v_requested_user_id. E178 — RU user not in requested unit. E179 — RU invalid v_requested_profile_id. E180 — RU invalid v_requested_dept_id.

Content type: application/json

Schema

PropertyTypeRequiredDescription
statusstringYesAlways "ER" for error responses
errorCodestringYesApplication-level error code (e.g. E204, E112, E302)
responsestringYesHuman-readable error message
{
  "type": "object",
  "example": {
    "status": "ER",
    "errorCode": "E204",
    "response": "Invalid or expired token"
  },
  "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. E204, E112, E302)"
    },
    "response": {
      "type": "string",
      "description": "Human-readable error message"
    }
  }
}

Example:

{
  "status": "ER",
  "errorCode": "E206",
  "response": "Cannot use both starting_after and ending_before simultaneously."
}

401 — Invalid or expired X-reflexis-csrf-token-X token (HTTP 401)

Content type: application/json

Schema

PropertyTypeRequiredDescription
statusstringYesAlways "ER" for error responses
errorCodestringYesApplication-level error code (e.g. E204, E112, E302)
responsestringYesHuman-readable error message
{
  "type": "object",
  "example": {
    "status": "ER",
    "errorCode": "E204",
    "response": "Invalid or expired token"
  },
  "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. E204, E112, E302)"
    },
    "response": {
      "type": "string",
      "description": "Human-readable error message"
    }
  }
}

Example:

{
  "status": "ER",
  "errorCode": "E204",
  "response": "Invalid or expired token"
}

500 — Unexpected server-side error

Content type: application/json

Schema

PropertyTypeRequiredDescription
statusstringYesAlways "ER" for error responses
errorCodestringYesApplication-level error code (e.g. E204, E112, E302)
responsestringYesHuman-readable error message
{
  "type": "object",
  "example": {
    "status": "ER",
    "errorCode": "E204",
    "response": "Invalid or expired token"
  },
  "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. E204, E112, E302)"
    },
    "response": {
      "type": "string",
      "description": "Human-readable error message"
    }
  }
}

Example:

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