List Security Feeds - Cloud Security API

{"type":"api","title":"List Security Feeds","meta":{"id":"/apps/pubhub/media/cloud-security-apis-in-eft/83e8a10367d157243cd1c3e478b807cb81262a3d/fb8a8151-5394-3d82-92c7-2af7325dde10","info":{"title":"Cisco Secure Access Security Feeds API","version":"1.0.2","description":"Create and manage the security feeds for the third-party and custom security vendors integrated in Secure Access.\nAfter you add a security feed, use the Secure Access Destination List API to add domains to the destination list for the security feed.\nSecure Access reviews the each domain in the security feed.\nIf Cisco Investigate assigns a **Popularity 90 day** normalized score below **40** for the domain,\nSecure Access adds the domain to the vendor's `thirdparty_block` destination list and blocks the domain.\nThe security feed's destination list has the `bundletypeId` of `1`.","contact":{"name":"Cloud Security Developer Community"}},"security":[{"oauthFlow":[]}],"tags":[{"name":"Feeds","description":"Manage the security feeds for the third-party and custom security vendors."}],"x-parser-conf":{"overview":{"markdownPath":"secure-access/reference/policies/security-feeds-overview.md","uri":"secure-access-api-reference-security-feeds-overview"}},"openapi":"3.0.1","servers":[{"url":"https://api.sse.cisco.com/{basePath}","variables":{"basePath":{"default":"policies/v2"}}}],"securitySchemes":{"oauthFlow":{"type":"oauth2","description":"The client credential flow.","flows":{"clientCredentials":{"tokenUrl":"https://api.sse.cisco.com/auth/v2/token","scopes":{"policies.feeds:write":"Write policies security security feeds","policies.feeds:read":"Read policies security security feeds"}}}}}},"spec":{"summary":"List Security Feeds","description":"List the security feeds for the third-party and custom security vendors integrated in Secure Access.","security":[{"oauthFlow":["policies.feeds:read"]}],"operationId":"getFeeds","tags":["Feeds"],"responses":{"200":{"description":"OK","headers":{"Content-Type":{"schema":{"type":"string"},"description":"The MIME content type of the response body.","example":"application/json","$$ref":"#/components/headers/Content-Type"},"Date":{"schema":{"type":"string","pattern":"^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$"},"description":"The timestamp of the response.","example":"2023-03-14T18:34:25Z","$$ref":"#/components/headers/Date"}},"content":{"application/json":{"schema":{"type":"array","description":"The list of security feeds for the integrated custom and third-party security vendors.","items":{"type":"object","description":"The properties of the security feed.","required":["id","name","organizationId","destinationListId","vendorId","createdAt","modifiedAt"],"properties":{"id":{"type":"integer","example":123,"description":"The ID of the security feed.","$$ref":"#/components/schemas/feedId"},"name":{"type":"string","description":"The name of the security feed.","example":"feed one","$$ref":"#/components/schemas/name"},"organizationId":{"type":"integer","description":"The ID of the organization.","example":1234567,"$$ref":"#/components/schemas/organizationId"},"destinationListId":{"type":"integer","description":"The ID of the destination list created for the security feed and security vendor integration.\nThe destination list has the `access` type of `thirdparty_block`.","example":1234,"$$ref":"#/components/schemas/destinationListId"},"vendorId":{"type":"integer","default":0,"description":"The ID of the third-party or custom security vendor.\nThe vendor ID for custom security vendors (`0`) is not required to create the security feed.\n| Security Vendor | Feed ID |\n| --------------------------- | -- |\n| Custom Feed | 0 |\n| FireEye | 1 |\n| Cyphort | 3 |\n| ZeroFOX | 5 |\n| ThreatQ | 8 |\n| ThreatConnect | 10 |\n| Cisco AMP Threat Grid | 11 |","example":1,"$$ref":"#/components/schemas/vendorId"},"enabled":{"type":"string","description":"Specify whether to enable the security feed.","enum":["Y","N"],"default":"N","example":"Y","$$ref":"#/components/schemas/enabled"},"createdAt":{"type":"string","format":"date-time","description":"The date and time when the system created the security feed. The system specifies the timestamp in the ISO 8601 format.","example":"2024-10-02T20:00:00Z"},"modifiedAt":{"type":"string","format":"date-time","description":"The date and time when the system updated the security feed. The system specifies the timestamp in the ISO 8601 format.","example":"2024-10-02T20:00:00Z"}},"example":{"id":123545,"name":"feed one","organizationId":146667,"destinationListId":15666,"vendorId":11,"enabled":"Y","createdAt":"2024-10-02T20:00:00Z","modifiedAt":"2024-10-02T20:00:00Z"},"$$ref":"#/components/schemas/feedObject"},"example":[{"id":123545,"name":"feed one","organizationId":146667,"destinationListId":15666,"vendorId":11,"enabled":"Y","createdAt":"2024-10-02T20:00:00Z","modifiedAt":"2024-10-02T20:00:00Z"}],"$$ref":"#/components/schemas/feeds"}}}},"400":{"description":"Bad Request","headers":{"Content-Type":{"schema":{"type":"string"},"description":"The MIME content type of the response body.","example":"application/json","$$ref":"#/components/headers/Content-Type"},"Date":{"schema":{"type":"string","pattern":"^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$"},"description":"The timestamp of the response.","example":"2023-03-14T18:34:25Z","$$ref":"#/components/headers/Date"}},"content":{"application/json":{"schema":{"type":"object","description":"Bad Request","properties":{"statusCode":{"type":"integer","example":400,"description":"HTTP status error code."},"error":{"type":"string","example":"error message","description":"The description of the error."},"message":{"type":"string","example":"Bad Request","description":"HTTP status error text."}},"$$ref":"#/components/schemas/BadRequestError"}}},"$$ref":"#/components/responses/InvalidRequest"},"401":{"description":"Unauthorized","headers":{"Content-Type":{"schema":{"type":"string"},"description":"The MIME content type of the response body.","example":"application/json","$$ref":"#/components/headers/Content-Type"},"Date":{"schema":{"type":"string","pattern":"^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$"},"description":"The timestamp of the response.","example":"2023-03-14T18:34:25Z","$$ref":"#/components/headers/Date"}},"content":{"application/json":{"schema":{"type":"object","description":"Unauthorized","properties":{"statusCode":{"type":"integer","example":401,"description":"HTTP status error code."},"error":{"type":"string","example":"error message","description":"The description of the error."},"message":{"type":"string","example":"Unauthorized","description":"HTTP status error text."}},"$$ref":"#/components/schemas/UnauthorizedError"}}},"$$ref":"#/components/responses/Unauthorized"},"403":{"description":"Forbidden","headers":{"Content-Type":{"schema":{"type":"string"},"description":"The MIME content type of the response body.","example":"application/json","$$ref":"#/components/headers/Content-Type"},"Date":{"schema":{"type":"string","pattern":"^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$"},"description":"The timestamp of the response.","example":"2023-03-14T18:34:25Z","$$ref":"#/components/headers/Date"}},"content":{"application/json":{"schema":{"type":"object","description":"Forbidden","properties":{"statusCode":{"type":"integer","example":403,"description":"HTTP status error code."},"error":{"type":"string","example":"error message","description":"The description of the error."},"message":{"type":"string","example":"Forbidden","description":"HTTP status error text."}},"$$ref":"#/components/schemas/ForbiddenError"}}},"$$ref":"#/components/responses/Forbidden"},"404":{"description":"Not Found","headers":{"Content-Type":{"schema":{"type":"string"},"description":"The MIME content type of the response body.","example":"application/json","$$ref":"#/components/headers/Content-Type"},"Date":{"schema":{"type":"string","pattern":"^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$"},"description":"The timestamp of the response.","example":"2023-03-14T18:34:25Z","$$ref":"#/components/headers/Date"}},"content":{"application/json":{"schema":{"type":"object","description":"Not Found","properties":{"statusCode":{"type":"integer","example":404,"description":"HTTP status error code."},"error":{"type":"string","example":"error message","description":"The description of the error."},"message":{"type":"string","example":"Not Found","description":"HTTP status error text."}},"$$ref":"#/components/schemas/NotFoundError"}}},"$$ref":"#/components/responses/NotFound"},"500":{"description":"Internal Server Error","headers":{"Content-Type":{"schema":{"type":"string"},"description":"The MIME content type of the response body.","example":"application/json","$$ref":"#/components/headers/Content-Type"},"Date":{"schema":{"type":"string","pattern":"^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$"},"description":"The timestamp of the response.","example":"2023-03-14T18:34:25Z","$$ref":"#/components/headers/Date"}},"content":{"application/json":{"schema":{"description":"Internal Server Error","type":"object","properties":{"statusCode":{"type":"integer","example":500,"description":"HTTP status error code."},"error":{"type":"string","example":"error message","description":"The description of the error."},"message":{"type":"string","example":"Internal Server Error","description":"HTTP status error text."}},"$$ref":"#/components/schemas/ServerError"}}},"$$ref":"#/components/responses/ServerError"}},"__originalOperationId":"getFeeds","method":"get","path":"/feeds"}}