{"type":"api","title":"Get list of CCO images","meta":{"id":"/apps/pubhub/media/crosswork-network-controller-7-2/76fd4bb9d069fd2530d7a02f0b3a4ca00eccfd35/f09e2906-53c8-3d4a-b731-512c8b9bc971","info":{"title":"Crosswork Workflow Manager Solutions - Image Repository","description":"The Image Repository APIs enable users to efficiently browse synchronized SMU and image data, assemble device-release lists, and download required files directly from CCO. This functionality streamlines the process of selecting optimal and feature-specific images and SMUs for various device releases.\n\nKey capabilities include browsing synchronized SMU/image information, assembling different types of device-release lists, and downloading selected images and SMUs. Users can leverage multiple filters to navigate the local repository, upload images, view metadata, and build IOS XR GISO images from stored ISO and SMUs.\n\nAdditionally, the APIs support synchronization with CCO catalogs, ensuring the local repository remains updated with the latest images and SMUs from Cisco.com. This helps maintain an up-to-date environment for image management and deployment.","contact":{"name":"Crosswork Team, Cisco","email":"support@cisco.com"},"license":{"name":"Cisco Software License Agreement","url":"https://www.cisco.com/public/sw-license-agreement.html"},"version":"7.2.0"},"x-parser-conf":{"overview":{"markdownPath":"reference/CWM-SOLUTIONS/repository-api.overview.md"}},"openapi":"3.0.1","servers":[{"url":"https://crosswork-ip:30603/crosswork/cwms/repository/v1"}],"securitySchemes":{"BearerAuth":{"type":"apiKey","description":"Type \"Bearer\" followed by a space and JWT token.","name":"Authorization","in":"header"}}},"spec":{"tags":["Cisco.com"],"summary":"Get list of CCO images","description":"Get list of CCO images","operationId":"getCCOImages","parameters":[{"name":"vendor","in":"query","description":"Vendor Name","schema":{"type":"string"}},{"name":"deviceFamily","in":"query","description":"Device Family","schema":{"type":"string"}},{"name":"productSeries","in":"query","description":"Product Series","schema":{"type":"string"}},{"name":"imageVersion","in":"query","description":"Image Version","schema":{"type":"string"}},{"name":"functionalArea","in":"query","description":"SMU Functional Area, A comma-separated list of values. Substring matches will be checked","schema":{"type":"string"}},{"name":"impact","in":"query","description":"SMU Impact","schema":{"type":"string"}},{"name":"search","in":"query","description":"Search string to filter images by name (supports partial matching)","schema":{"type":"string"}},{"name":"optimal","in":"query","description":"if =true returns Optimal Images Only","schema":{"type":"string"}},{"name":"pageNumber","in":"query","description":"Pagination Page Number","schema":{"type":"integer"}},{"name":"pageSize","in":"query","description":"Pagination Page Size","schema":{"type":"integer"}}],"responses":{"200":{"description":"Image List","content":{"application/json":{"schema":{"type":"object","properties":{"images":{"type":"array","description":"List of Images","items":{"type":"object","properties":{"createdBy":{"type":"string","description":"CreatedBy is the user who created/synced the record","example":"admin"},"creationDate":{"type":"string","description":"Date when image is created","example":"2025-12-16T23:14:22.412741-08:00"},"functionalArea":{"type":"string","description":"Functional Area of the image","example":"FORWARDING"},"id":{"type":"string","description":"ID of the image","example":"AA30658/47118"},"imagePlatform":{"type":"string","description":"Image Platform or Software Type","example":"IOS XR"},"imageType":{"type":"string","description":"Type of the image","example":"SMU/ISO/GISO"},"imageVersion":{"type":"string","description":"Version of the image","example":"24.2.11"},"impact":{"type":"string","description":"Impact of the image","example":"Needs Reboot"},"lastUpdatedDate":{"type":"string","description":"Date when image is last updated","example":"04/10/2025 23:18:49 PDT"},"localImageId":{"type":"string","description":"Reference to the local image","example":"47118"},"name":{"type":"string","description":"Name of the image","example":"8000-24.2.11.CSCwk62108.tar"},"productSeries":{"type":"string","description":"Product Series of the image","example":"Cisco 8000 Series Routers"},"productSeriesShort":{"type":"string","description":"Short Name of the Product Series","example":"CISCO 8K"},"syncDate":{"type":"string","description":"Date when the image was last synced from CCO","example":"2025-12-15T13:08:17.704084-08:00"},"vendor":{"type":"string","description":"Vendor of the image","example":"Cisco Systems"}},"description":"Image Object","$$ref":"#/components/schemas/CCOImage"}},"pagination":{"type":"object","properties":{"pageNumber":{"type":"integer","description":"Current Page Number","example":1},"pageSize":{"type":"integer","description":"Number of records per page","example":30},"total":{"type":"integer","description":"Query string `json:\"query,omitempty\" default:\"\"`\nTotal number of records","example":1}},"description":"Pagination","$$ref":"#/components/schemas/Pagination"}},"description":"CCO Image List","$$ref":"#/components/schemas/ImageList"}}}},"204":{"description":"No Content","content":{}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error Message","example":"Forbidden"}},"description":"Forbidden Response","$$ref":"#/components/schemas/StatusForbidden"}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Status Code","example":406},"message":{"type":"string","description":"Message","example":"Not Acceptable"},"status":{"type":"string","description":"Status","example":"Failed"}},"description":"Request Not Acceptable Response","$$ref":"#/components/schemas/StatusNotAcceptable"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Status Code","example":500},"message":{"type":"string","description":"Message","example":"Internal Server Error"},"status":{"type":"string","description":"Status","example":"Failed"}},"description":"Backend Error Response","$$ref":"#/components/schemas/StatusInternalServerError"}}}},"503":{"description":"Service Unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Status Code","example":503},"message":{"type":"string","description":"Message","example":"Service Unavailable"},"status":{"type":"string","description":"Status","example":"Failed"}},"description":"Maintenance Mode Response","$$ref":"#/components/schemas/StatusServiceUnavailable"}}}}},"security":[{"BearerAuth":[]}],"__originalOperationId":"getCCOImages","method":"get","path":"/cco/image"}}