List all notes on a feed
GET /task/v1/feeds/{feed_key}/notes
Operation id: getFeedNotes
Description
Retrieves all notes associated with the specified feed. Returns feed_notes_arr[] — an empty array is a valid OK response (no notes). Service null → E303. Requires FEED_ACCESS line-of-sight authorization.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
feed_key | Integer | Yes | Numeric key identifying the feed item |
Response Fields — feed_notes_arr[*]
| Field | Type | Description |
|---|---|---|
domain_id | Integer | Domain ID |
feed_key | Integer | Feed key the note belongs to |
notes_id | Integer | Unique note identifier |
unit_id | String | Unit identifier |
cluster_id | String | Cluster identifier |
cluster_child_id | String | Cluster child identifier |
creator_id | String | User ID of the note creator |
creator_name | String | Display name of the note creator |
notes_content | String | Text content of the note |
creation_time | String | Formatted creation timestamp |
last_updated_time | String | Formatted last-update timestamp |
Error Scenarios
| Scenario | HTTP | Error Code | Message |
|---|---|---|---|
Missing / invalid X-reflexis-csrf-token-X | 401 | E202 | User session is invalid |
| Service returned null | 200 | E303 | Unable to fetch notes |
| Unexpected server-side error | 500 | E302 | Internal server error |
Error Codes Reference
| Code | Description |
|---|---|
E202 | User session is invalid |
E302 | Internal server error |
E303 | Unable to fetch notes |
Tags: MyWorkFeeds
Parameters
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
feed_key | integer | Yes | Unique numeric feed identifier |
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, feed_notes_arr[]}
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, feed_notes_arr[]}
Content type: application/json
Schema
JSON object (structure varies by endpoint).
{
"type": "object",
"description": "JSON object (structure varies by endpoint)."
}
Example:
{
"status": "OK",
"feed_notes_arr": [
{
"notes_id": 42,
"feed_key": 101,
"unit_id": "UNIT_01",
"cluster_id": "CLUSTER_A",
"cluster_child_id": "CHILD_B",
"creator_id": "SYSADMIN",
"creator_name": "System Administrator",
"notes_content": "Sample note content",
"creation_time": "2024-01-15 10:00:00",
"last_updated_time": "2024-01-15 11:00:00"
}
]
}
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"
}