Available comment / message reason codes
GET /task/v1/comments/configs
Operation id: getCommentCodes
Description
Retrieves available comment codes for the authenticated user. Returns comment_codes with sent_to[] (recipient targets) and reason_code[] arrays. Requires ROS_UNIT_DOMAIN line-of-sight authorization.
Tags: MyWorkComments
Parameters
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
cluster_id | string | No | Filter codes by cluster; -1 or absent = domain-wide codes |
reassign | string | No | Y to retrieve reassignment codes; N (default) for standard message codes |
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 — {status: OK, comment_codes: {sent_to[], reason_code[]}}
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, comment_codes: {sent_to[], reason_code[]}}
Content type: application/json
Schema
JSON object (structure varies by endpoint).
{
"type": "object",
"description": "JSON object (structure varies by endpoint)."
}
Example:
{
"status": "OK",
"comment_codes": {
"sent_to": [
{
"seq_no": "2036",
"display_name": "0010 - REE_10 - 0010 (dist_mgr)",
"value": "[{\"USER_INFO\":[],\"UNIT\":\"0010\",\"PROFILE\":\"DIST_MGR\"}]"
}
],
"reason_code": [
{
"label": "Damaged Product",
"key": "1605803554243"
},
{
"label": "Missing Information",
"key": "MI"
}
]
}
}
401 — Missing or invalid X-reflexis-csrf-token-X session token
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. E202, E105, E404) |
response | string | Yes | Human-readable error message |
{
"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
| Property | Type | Required | Description |
|---|---|---|---|
status | string | Yes | Always "ER" for error responses |
errorCode | string | Yes | Application-level error code (e.g. E202, E105, E404) |
response | string | Yes | Human-readable error message |
{
"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"
}