{"type":"api","title":"List Incident Entities","meta":{"id":"/apps/pubhub/media/cloud-security-apis-in-eft/83e8a10367d157243cd1c3e478b807cb81262a3d/eadd0b56-ea60-32bd-a1aa-155c29b52bed","info":{"title":"Cisco Cloudlock API","description":"The Cloudlock API provides data about an organization's activities, apps, incidents, and policies.","version":"1.0.0","contact":{"name":"Cloud Security Developer Community"}},"tags":[{"name":"Activities"},{"name":"Apps"},{"name":"Entities"},{"name":"Incidents"},{"name":"Incident Aggregates"},{"name":"Incident Entities"},{"name":"IP Libraries"},{"name":"Policies"}],"openapi":"3.0.0","servers":[{"url":"https://api.cloudlock.com/api/v2"}]},"spec":{"tags":["Incident Entities"],"description":"Get the detailed entity information for an entity involved in an incident.\nThere is a limit of up to 100 ACL's and the data is reflective of the last time we scanned the\ndocument (not when the incident was created).\n\nUsage:\nFirst get an incident/incidents. Then take the id value from the entity\nobject within the incident and call the incident_entities endpoint using\nthat entitys id (not the incident id).\n\nExample:\nYou have an incident which has an ID of 528815. Lookup the entity id for\nthis incident, then use this entity id to get the entity information.","operationId":"listIncidentEntities","summary":"List Incident Entities","parameters":[{"description":"The ID of the entity in the incident.","example":513266,"in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","description":"The information about the object relating to this incident.","properties":{"acl":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"value":{"type":"string"},"role":{"type":"string"},"type":{"type":"string"},"status":{"type":"string"},"created_on":{"type":"string"},"vendor":{"type":"object","properties":{"name":{"type":"string","description":"The name of the vendor. For example: google."}},"$$ref":"#/components/schemas/Vendor"},"origin_id":{"type":"string"}}}},"entity":{"type":"object","description":"The information about the object relating to this incident.","properties":{"direct_url":{"type":"string","description":"The URL to the object."},"extra":{"type":"object","description":"The additional information related to the incident.","properties":{"origin_type_label":{"type":"string","description":"This field gives additional info regarding the scanned object that triggered the policy violation."},"origin_type_label_plural":{"type":"string","description":"Similar to the origin_type_label but for a plural label"}}},"id":{"type":"string","description":"This is Cloudlock Internal Identifier for an entity."},"mime_type":{"type":"string","description":"The mime type of the object/document (if any)"},"name":{"type":"string","description":"The name of the underlying object represented by this entity."},"origin_id":{"type":"string","description":"This is the identifier of the object in the vendor system."},"origin_type":{"type":"string","description":"The object type (i.e. document, post, app, event)."},"owner_email":{"type":"string","description":"Object owner's email address (e.g. user@cloudlock.com)."},"owner_name":{"type":"string","description":"Object owner's name (i.e. John Q. User)."},"vendor":{"type":"object","properties":{"name":{"type":"string","description":"The name of the vendor. For example: google."}},"$$ref":"#/components/schemas/Vendor"}},"$$ref":"#/components/schemas/Entity"}},"$$ref":"#/components/schemas/IncidentEntity"},"examples":{"response":{"value":{"id":"513266","name":"Logins for EC2 Instances.xlsx","user":"","owner_name":"","owner_vendor_id":"","acl":[{"created_on":"2021-02-27 20:18:38.799158","id":"2823","origin_id":"","role":"viewer","status":"ACTIVE","type":"public_with_link","value":"public_with_link","vendor":{"name":"box"}}]}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"$$ref":"#/components/responses/400Error"},"401":{"description":"Unauthorized request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"$$ref":"#/components/responses/401Error"},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"$$ref":"#/components/responses/403Error"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"$$ref":"#/components/responses/404Error"},"500":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"$$ref":"#/components/responses/500Error"}},"__originalOperationId":"listIncidentEntities","method":"get","path":"/incident_entities/{id}"}}