{"type":"api","title":"List Protocols","meta":{"id":"/apps/pubhub/media/cloud-security-apis-in-eft/d2a1854d5c0ed9069a7f0bc54a9b813f3075ddc9/5477656b-8124-3422-839e-4b90bc91faa4","info":{"title":"Cisco Secure Access App Discovery API","description":"The App Discovery API provides an overall view of application and protocol activity in your environment\nand the potential risk indicated by this network traffic.","version":"2.0.2","contact":{"name":"Cloud Security Developer Community"}},"tags":[{"name":"Applications"},{"name":"Application Categories"},{"name":"Protocols"},{"name":"Identities"},{"name":"Secure Access"}],"x-parser-conf":{"overview":{"markdownPath":"secure-access/reference/reports/app-discovery-overview.md","uri":"secure-access-api-reference-app-discovery-overview"}},"openapi":"3.0.1","servers":[{"url":"https://api.sse.cisco.com/{basePath}","variables":{"basePath":{"default":"reports/v2"}}}],"securitySchemes":{"oauthFlow":{"type":"oauth2","description":"client credential flow","flows":{"clientCredentials":{"tokenUrl":"https://api.sse.cisco.com/auth/v2/token","scopes":{"reports.appDiscovery:write":"Write reports app discovery","reports.appDiscovery:read":"Read reports app discovery"}}}}}},"spec":{"tags":["Protocols","Secure Access"],"summary":"List Protocols","description":"List all protocols.","operationId":"getProtocols","parameters":[{"in":"query","name":"identity","schema":{"type":"integer"},"description":"Specify the entity ID to filter the collection.","example":12355,"$$ref":"#/components/parameters/identity"},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100},"description":"The maximum number of items to return in the collection.","$$ref":"#/components/parameters/limit"},{"in":"query","name":"offset","schema":{"type":"integer"},"description":"The number of items to skip before starting to collect the result set.","$$ref":"#/components/parameters/offset"},{"in":"query","name":"sort","schema":{"type":"string","enum":["firstDetected","lastDetected"]},"description":"Specify the name of a field to sort the application protocols.","example":"firstDetected","$$ref":"#/components/parameters/protocolsSort"},{"in":"query","name":"order","schema":{"type":"string","enum":["asc","desc"]},"description":"Specify the order to sort the collection. Valid values are: `asc` (ascending)\nor `desc` (descending).","example":"asc","$$ref":"#/components/parameters/order"}],"security":[{"oauthFlow":["reports.appDiscovery:read"]}],"responses":{"200":{"description":"OK","headers":{"Link":{"schema":{"type":"string"},"description":"Links to related resources, in the format defined by\n[RFC 5988](https://tools.ietf.org/html/rfc5988#section-5).\nIf there is a next page, this header includes a link with relation type\n`next` to the next page.","$$ref":"#/components/headers/Link"}},"content":{"application/json":{"schema":{"type":"object","description":"The list of the app's protocol information.","properties":{"items":{"type":"array","items":{"type":"object","description":"The app's protocol information.","required":["id","name","description","events","blockedEvents","firstDetected","lastDetected"],"properties":{"id":{"type":"string","description":"The ID of the protocol.","example":"0j1b5EmA"},"name":{"type":"string","description":"The name of the protocol.","example":"ftp"},"description":{"type":"string","description":"The description of the protocol.","example":"File Transfer Protocol"},"events":{"type":"integer","example":100},"blockedEvents":{"type":"integer","example":50},"firstDetected":{"type":"string","format":"date-time","description":"The date and time (ISO 8601 timestamp) when the app protocol was first detected.","example":"2022-01-01T00:00:00.000Z"},"lastDetected":{"type":"string","format":"date-time","description":"The date and time (ISO 8601 timestamp) when the app protocol was last detected.","example":"2022-01-01T00:00:00.000Z"}},"example":{"id":"0j1b5EmA","name":"ftp","description":"File Transfer Protocol","events":100,"blockedEvents":50,"firstDetected":"2022-01-01T00:00:00.000Z","lastDetected":"2022-01-01T00:00:00.000Z"},"$$ref":"#/components/schemas/ProtocolObjectInList"}}},"example":{"items":[{"id":"0j1b5Em","name":"ftp","description":"File Transfer Protocol","events":100,"blockedEvents":50,"firstDetected":"2022-01-01T00:00:00.000Z","lastDetected":"2022-01-01T00:00:00.000Z"}]},"$$ref":"#/components/schemas/ProtocolList"},"example":{"items":[{"id":"0j1b5Eh","name":"ftp","description":"File Transfer Protocol","events":100,"blockedEvents":50,"firstDetected":"2022-01-01T00:00:00.000Z","lastDetected":"2022-01-01T00:00:00.000Z"}]}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","description":"The error message returned in the response.","properties":{"message":{"type":"string"}},"$$ref":"#/components/schemas/Error"}}},"$$ref":"#/components/responses/InvalidRequest"},"401":{"description":"Unauthorized request","content":{"application/json":{"schema":{"type":"object","description":"The error message returned in the response.","properties":{"message":{"type":"string"}},"$$ref":"#/components/schemas/Error"}}},"$$ref":"#/components/responses/Unauthorized"},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","description":"The error message returned in the response.","properties":{"message":{"type":"string"}},"$$ref":"#/components/schemas/Error"}}},"$$ref":"#/components/responses/Forbidden"},"500":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","description":"The error message returned in the response.","properties":{"message":{"type":"string"}},"$$ref":"#/components/schemas/Error"}}},"$$ref":"#/components/responses/ServerError"}},"__originalOperationId":"getProtocols","method":"get","path":"/appDiscovery/protocols"}}