---
schema_version: "1"
id: e23cd2468b3e8fccebc6de0474e34f24fa3d72f55b955caad324b7b43fbf3e38
title: Security | Retrieve Investigation
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/ai/264-0-0/agent_ref_retrieve_investigation.md
canonical_url: https://help.salesforce.com/s/articleView?id=ai.agent_ref_retrieve_investigation.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 89e3d7ba32246a33339f15185a45ce70a6b6353fb36565a91fa2c0ad130f9b91
description: Returns a complete security investigation, including findings, timeline entries, and impacted instances.
products:
  - Agentforce
  - Cross Cloud
release: "264"
---
# Security | Retrieve Investigation

Returns a complete security investigation, including findings, timeline entries, and impacted instances.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: Lightning Experience</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: <strong>Enterprise</strong>, <strong>Performance</strong>, <strong>Unlimited</strong>, and <strong>Developer</strong> Editions with the Security Center add-on and Foundations or <strong>Agentforce 1</strong> Editions.</td></tr></tbody></table>

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d165033e75">User Permissions Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d165033e75 ">To view Security Center pages:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d165033e75 ">View Security Center</td>

          </tr>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d165033e75 ">To create and edit security policies:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d165033e75 ">Manage Security Center</td>

          </tr>
          <tr class="">
            <td class="slds-cell-wrap" colspan="2" style="vertical-align:top;" headers="d165033e75 ">See <a href="https://help.salesforce.com/s/articleView?id=ai.agent_actions_common_perms.htm&amp;type=5&amp;language=en_US" target="_blank">Common User Access for Standard Agent
                Actions</a>.</td>

          </tr>
        </tbody>
      </table>

## Action Details

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small "><colgroup><col style="width:50%"> <col style="width:50%"></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">API Name</td><td class="slds-cell-wrap" style="vertical-align:top;">RetrieveInvestigation</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Reference Action Type</td><td class="slds-cell-wrap" style="vertical-align:top;">Standard Action</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Does this tool run one or more prompt templates?</td><td class="slds-cell-wrap" style="vertical-align:top;">No</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Required setup</td><td class="slds-cell-wrap" style="vertical-align:top;">Turn on Security Center and Security Agent with View Security Center or Manage Security Center user permission.</td></tr></tbody></table>

## Guidelines and Considerations

Use `RetrieveInvestigation` to retrieve the full context of an existing security investigation.

- Requires an investigation ID to retrieve the complete investigation record.
- Returns all associated findings, timeline entries, and impacted instances in a single call.