{"type":"model","meta":{"id":"/apps/pubhub/media/cloud-security-apis-in-eft/9d37d008417d562ab46d4b67547a68457ce288d2/a7bd8f51-2771-3681-9b16-1dc760bb94cc","info":{"title":"Cisco Secure Access Destination Lists API","version":"2.0.1","description":"Create and manage destination lists and destinations.","contact":{"name":"Cloud Security Developer Community"}},"security":[{"oauthFlow":[]}],"tags":[{"name":"Destination Lists","description":"Destination Lists"},{"name":"Destinations","description":"Destinations"},{"name":"Secure Access"}],"x-parser-conf":{"overview":{"markdownPath":"secure-access/reference/policies/destination-lists-overview.md","uri":"secure-access-api-reference-destination-lists-overview"}},"openapi":"3.0.1","servers":[{"url":"https://api.sse.cisco.com/{basePath}","variables":{"basePath":{"default":"policies/v2"}}}],"securitySchemes":{"oauthFlow":{"type":"oauth2","description":"client credential flow","flows":{"clientCredentials":{"tokenUrl":"https://api.sse.cisco.com/auth/v2/token","scopes":{"policies.destinationLists:write":"Write policies destination lists","policies.destinationLists:read":"Read policies destination lists","policies.destinations:write":"Write policies destinations","policies.destinations:read":"Read policies destinations"}}}}}},"spec":{"type":"object","description":"The status, metadata, and properties of the destination lists.","required":["status","meta","data"],"properties":{"status":{"type":"object","required":["code","text"],"description":"The status information for the response.","properties":{"code":{"type":"integer","description":"The HTTP status code of the response.","example":200},"text":{"type":"string","description":"The HTTP message that describes the response.","example":"OK"}},"example":{"code":200,"text":"OK"},"$$ref":"#/components/schemas/status"},"meta":{"type":"object","description":"The pagination information for the response.","properties":{"page":{"type":"integer","description":"The number of the page in the collection.","example":50},"limit":{"type":"integer","description":"The maximum number of items the server returns on the page.","example":10},"total":{"type":"integer","description":"The total number of items in the collection.","example":20}},"$$ref":"#/components/schemas/meta"},"data":{"type":"array","description":"The list of destination lists.","items":{"type":"object","required":["id","organizationId","access","isGlobal","name","thirdpartyCategoryId","createdAt","modifiedAt","isMspDefault","markedForDeletion"],"properties":{"id":{"type":"integer","example":1234567,"description":"The unique ID of the destination list.","$$ref":"#/components/schemas/id"},"organizationId":{"type":"integer","example":2345678,"description":"The organization ID.","$$ref":"#/components/schemas/organizationId"},"access":{"type":"string","example":"none","description":"Configure your access rules to block or allow certain destination lists.\nNo support for the access type on destination lists.\nValid values are: `allow`, `block`, `url_proxy`, `no_decrypt`, `warn`, `none`, or `third_party_block`.","enum":["allow","block","url_proxy","no_decrypt","warn","none","thirdparty_block"],"$$ref":"#/components/schemas/access"},"isGlobal":{"type":"boolean","example":false,"description":"Specifies whether the destination list is a global destination list.\nThere is only one default `allow` destination list and one default `block` destination list for an organization.\n**Note:** No support for global destination lists. When you creat a destination list, set the `isGlobal` field to `false`.","$$ref":"#/components/schemas/isGlobal"},"name":{"type":"string","example":"Global Allow list","description":"The name of the destination list.","$$ref":"#/components/schemas/name"},"thirdpartyCategoryId":{"type":"integer","example":1,"description":"The third-party category ID of the destination list."},"createdAt":{"type":"integer","example":1490206249,"description":"The date and time when the system created the destination list."},"modifiedAt":{"type":"integer","example":1520476127,"description":"The date and time when the system modified the destination list."},"isMspDefault":{"type":"boolean","description":"Specifies whether MSP is the default.","example":false},"markedForDeletion":{"type":"boolean","example":false,"description":"Specifies whether the system marks the destination list for deletion."},"bundleTypeId":{"type":"integer","enum":[2],"example":2,"description":"The type of the destination list.\nIn your policy rules, the system applies security controls to your destination lists.\n**Note:** When you create a destination list, set the `bundleTypeId` to `2`.","$$ref":"#/components/schemas/bundleTypeId"},"meta":{"type":"object","description":"The total number of each type of destination in the destination list. The fields in the `meta` object are optional.","properties":{"destinationCount":{"type":"integer","example":5,"description":"The total number of destinations in a destination list."},"domainCount":{"type":"integer","example":5,"description":"The total number of domains in a destination list.\nDomains are part of the total number of destinations in a destination list."},"urlCount":{"type":"integer","example":0,"description":"The total number of URLs in a destination list.\nUrls are part of the total number of destinations in a destination list."},"ipv4Count":{"type":"integer","example":0,"description":"The total number of IPv4 addresses in a destination list.\nIPv4 addresses are part of the total number of destinations in a destination list."},"ipv6Count":{"type":"integer","example":0,"description":"The total number of IPv6 addresses in a destination list.\nIPv6 addresses are part of the total number of destinations in a destination list."},"applicationCount":{"type":"integer","example":0,"description":"The total number of applications in a destination list.\nApplications are part of the total number of destinations in a destination list."}},"example":{"domainCount":1,"urlCount":0,"ipv4Count":1,"ipv6Count":0,"destinationCount":2,"applicationCount":0}}},"example":{"id":1234567,"organizationId":2345678,"access":"none","isGlobal":false,"name":"Global Allow List","thirdpartyCategoryId":0,"createdAt":1490206249,"modifiedAt":1520476127,"isMspDefault":false,"markedForDeletion":false,"bundleTypeId":2,"meta":{"destinationCount":5,"domainCount":5,"urlCount":0,"ipv4Count":0,"ipv6Count":0,"applicationCount":0}},"$$ref":"#/components/schemas/DestinationListObject"}}},"$$ref":"#/components/schemas/PaginatedDestinationListsResponse","title":"PaginatedDestinationListsResponse"}}