All feeds for a project cluster (no pagination)

GET /task/v1/feeds/{cluster_id}/cluster-list

Operation id: retrieveClusterFeeds

Description

Returns all feeds belonging to a specific project cluster in one call. Does not support cursor-based pagination. cluster_id must not be blank, "-1", or the literal string "null" (→ E108). Empty results → E117 (not an empty array). When view_type=MV, only clusters owned by the requesting user are returned; unowned clusters → E117. When status filter is supplied and no feeds match, → E117. Unknown projections field names → E149 (400). The literal string "null" passed as projections is treated as absent (default fields returned).

Projections — Default Fields

When projections is omitted, the following fields are returned per feed: 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, last_action_time, last_action_time_in_millis

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

Path Parameters

ParameterTypeRequiredDescription
cluster_idStringYesProject cluster identifier. Must not be blank, "-1", or literal "null".

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
cluster_id is blank, "-1", or literal "null"400E108Cluster Id is mandatory
Invalid projections field name(s)400E149Invalid projection value.
No feeds found for the cluster200E117No project record found for the given cluster_id.
view_type=MV and cluster not assigned to requesting user200E117No project record found for the given cluster_id.
status filter applied and no feeds match200E148No feeds found for the requested status filter.

Error Codes Reference

CodeDescription
E108Invalid or missing cluster_id path parameter
E149Invalid projections field name(s)
E117No feeds found for the given cluster
E204Invalid or expired token

Tags: MyWorkFeeds

Parameters

Path parameters

NameTypeRequiredDescription
cluster_idstringYesProject cluster identifier (must not be blank or "-1")

Query parameters

NameTypeRequiredDescription
dept_idstringNoOptional comma-separated department ids. When present, requires view_type=DV and LOS validation. When omitted, session dept_id is used.
projectionsstringNoComma-separated field names to include in each feed object
statusstringNoComma-separated status codes to filter (e.g. N,R,P,C)
view_typestringNoView type: MV=My View, DV=Department View, SV=Store View

Security

  • ApiKeyHeader (apiKey)
    • APIGEE API key header validated by VerifyAPIKey policy.
  • AuthTokenHeader (apiKey)
    • Session authentication token validated server-side against the user session store.

Responses

200 — Success — cluster_feed_list[] or E117 no-project error

Content type: application/json

400 — E108 — cluster_id is mandatory (blank or -1)

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 — cluster_feed_list[] or E117 no-project error

Content type: application/json

Schema

JSON object (structure varies by endpoint).

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

Example:

{
  "status": "OK",
  "cluster_feed_list": []
}

400 — E108 — cluster_id is mandatory (blank or -1)

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

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