Save filter (upsert on duplicate name)
POST /task/v1/feed-filters
Operation id: saveFeedFilter
Description
Creates a custom filter. Duplicate name for the same user/category updates criteria (upsert). Form-urlencoded body. Identity from session only. Calendar example: category=CALENDAR + sub_filter_data_category=<sourceId> + full criteria DSL.
Tags: MyWorkFeedFilters
Security
- AuthTokenHeader (apiKey)
- Session authentication token validated server-side against the user session store.
Responses
200 — {status: OK, feed_filter: {filter_id, filter_name, filter_criteria, created_by}}
Content type: application/json
400 — E380 missing filter_name; E381 missing filter_criteria; E390 invalid category
Content type: application/json
401 — Invalid or expired X-reflexis-csrf-token-X token (HTTP 401)
Content type: application/json
500 — E383 unable to save
Content type: application/json
Request body
Required: Yes
application/x-www-form-urlencoded
Schema
| Property | Type | Required | Description |
|---|---|---|---|
filter_name | string | Yes | |
filter_criteria | string | Yes | Semicolon KEY:value; DSL |
category | string | No | Defaults to FEED |
sub_filter_data_category | string | No | Calendar/gantt source id |
{
"type": "object",
"required": [
"filter_name",
"filter_criteria"
],
"properties": {
"filter_name": {
"type": "string"
},
"filter_criteria": {
"type": "string",
"description": "Semicolon KEY:value; DSL"
},
"category": {
"type": "string",
"description": "Defaults to FEED",
"enum": [
"FEED",
"CALENDAR",
"GANTT"
]
},
"sub_filter_data_category": {
"type": "string",
"description": "Calendar/gantt source id"
}
}
}
Response models
200 — {status: OK, feed_filter: {filter_id, filter_name, filter_criteria, created_by}}
Content type: application/json
Schema
JSON object (structure varies by endpoint).
{
"type": "object",
"description": "JSON object (structure varies by endpoint)."
}
400 — E380 missing filter_name; E381 missing filter_criteria; E390 invalid category
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 — E383 unable to save
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"
}
}
}