Latest comments since last poll (incremental refresh)
GET /task/v1/comments/list/latest
Operation id: getLatestComments
Description
Retrieves only comments that have changed since the last poll. This is a dependent call — from_time must be set to the last_fetch_time value returned by a prior /list or /list/latest response. from_time is validated against the maximum refresh interval — exceeded → E312. Requires ROS_UNIT_DOMAIN line-of-sight authorization.
Tags: MyWorkComments
Parameters
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
from_time | integer (int64) | Yes | Required. Epoch ms — timestamp from last_fetch_time of the previous /list or /list/latest response. Missing or blank → E157. |
msg_type | string | No | Feed/message type token (default PROJECTEXTRACT) |
unit_category | string | No | Filter by unit category |
view_type | string | No | SV, MV, DV; defaults to session current view if omitted |
Security
- AuthTokenHeader (apiKey)
- Session authentication token validated server-side against the user session store.
Responses
200 — Success — {comment_data_list[], proj_data_list[], count_data[], last_fetch_time}.
No data → E404. Refresh interval exceeded → E312 (500).
Content type: application/json
400 — E157 — from_time is missing or blank.
E158 — from_time is not a valid numeric epoch timestamp.
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 — {comment_data_list[], proj_data_list[], count_data[], last_fetch_time}.
No data → E404. Refresh interval exceeded → E312 (500).
Content type: application/json
Schema
JSON object (structure varies by endpoint).
{
"type": "object",
"description": "JSON object (structure varies by endpoint)."
}
400 — E157 — from_time is missing or blank.
E158 — from_time is not a valid numeric epoch timestamp.
Content type: application/json
Schema
| Property | Type | Required | Description |
|---|---|---|---|
status | string | Yes | Always "ER" for error responses |
errorCode | string | Yes | Application-level error code (e.g. E204, E112, E302) |
response | string | Yes | Human-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
| Property | Type | Required | Description |
|---|---|---|---|
status | string | Yes | Always "ER" for error responses |
errorCode | string | Yes | Application-level error code (e.g. E204, E112, E302) |
response | string | Yes | Human-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
| Property | Type | Required | Description |
|---|---|---|---|
status | string | Yes | Always "ER" for error responses |
errorCode | string | Yes | Application-level error code (e.g. E204, E112, E302) |
response | string | Yes | Human-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"
}