---
schema_version: "1"
id: b178cf8c726f6aadede27bd839d951b2fd9ba3d951572564b202efc7d12f6d2c
title: agent test resume
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/salesforcedx/sfclireference/guides/agent/cli_reference_agent_test_resume.md
canonical_url: https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_test_resume.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 9f5796e39246217ee09cf1b95705823642611fe7d5e862c941a3a617d27b8fb9
products:
- Salesforce CLI Command Reference
- salesforcedx
---
# agent test resume
Resume an agent test that you previously started in your org so you can view the test results.
## Description for agent test resume
This command requires a job ID, which the original "agent test run" command displays when it completes. You can also use the --use-most-recent flag to see results for the most recently run agent test.
Use the --wait flag to specify the number of minutes for this command to wait for the agent test to complete; if the test completes by the end of the wait time, the command displays the test results. If not, the CLI returns control of the terminal to you, and you must run "agent test resume" again.
By default, this command outputs test results in human-readable tables for each test case. The tables show whether the test case passed, the expected and actual values, the test score, how long the test took, and more. Use the --result-format to display the test results in JSON or Junit format. Use the --output-dir flag to write the results to a file rather than to the terminal.
## Flags
| Flag Name (Long) | Flag Name (Short) | Description |
|------------------|-------------------|-------------|
| ‑‑api‑version | N/A | **Type:** Value
Override the api version used for api requests made by this command |
| ‑‑flags‑dir | N/A | **Type:** Value
Import flag values from a directory. |
| ‑‑job‑id | ‑i | **Type:** Value
Job ID of the original agent test run. |
| ‑‑json | N/A | **Type:** Boolean
Format output as json. |
| ‑‑output‑dir | ‑d | **Type:** Value
Directory to write the agent test results into.
If the agent test run completes, write the results to the specified directory. If the test is still running, the test results aren't written. |
| ‑‑result‑format | N/A | **Type:** Value
**Valid Values:** `json`, `human`, `junit`, `tap`
**Default value:** `human`
Format of the agent test run results. |
| ‑‑target‑org | ‑o | **Type:** Value
**Required**
Username or alias of the target org. Not required if the `target-org` configuration variable is already set. |
| ‑‑test‑runner | N/A | **Type:** Value
**Valid Values:** `agentforce-studio`, `testing-center`
Explicitly specify which test runner to use (agentforce-studio or testing-center).
By default, the command automatically detects which test runner to use based on the test definition metadata type in your org. Use this flag to explicitly specify the runner type. 'agentforce-studio' uses AiTestingDefinition metadata. 'testing-center' uses AiEvaluationDefinition metadata. |
| ‑‑use‑most‑recent | ‑r | **Type:** Boolean
Use the job ID of the most recent agent test run. |
| ‑‑verbose | N/A | **Type:** Boolean
Show generated data in the test results output.
When enabled, includes detailed generated data (such as invoked actions) in the human-readable test results output. This is useful for debugging test failures and understanding what actions were actually invoked during the test run.
The generated data is in JSON format and includes the Apex classes or Flows that were invoked, the Salesforce objects that were touched, and so on. Use the JSON structure of this information to build the test case JSONPath expression when using custom evaluations. |
| ‑‑wait | ‑w | **Type:** Value
Number of minutes to wait for the command to complete and display results to the terminal window. |
## Examples for agent test resume
Resume an agent test in your default org using a job ID:
```shell
sf agent test resume --job-id 4KBfake0000003F4AQ
```
Resume the most recently-run agent test in an org with alias "my-org" org; wait 10 minutes for the tests to finish:
```shell
sf agent test resume --use-most-recent --wait 10 --target-org my-org
```
Resume the most recent agent test in your default org, and write the JSON-formatted results into a directory called "test-results":
```shell
sf agent test resume --use-most-recent --output-dir ./test-results --result-format json
```