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

  • 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 — {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

PropertyTypeRequiredDescription
filter_namestringYes
filter_criteriastringYesSemicolon KEY:value; DSL
categorystringNoDefaults to FEED
sub_filter_data_categorystringNoCalendar/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

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 — E383 unable to save

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