---
title: "POST /ListPentests"
method: POST
path: "/ListPentests"
---

# POST /ListPentests

`POST /ListPentests`

Returns a paginated list of pentest summaries for the specified agent space.

## Request body

- object
  - `maxResults` integer — Maximum results for pagination.
  - `nextToken` string — Pagination token.
  - `agentSpaceId` string, required — The unique identifier of the agent space to list pentests for.

## Response `200`

Success

- ListPentestsOutput — Output for the ListPentests operation.
  - `pentestSummaries` PentestSummary[] — The list of pentest summaries.
    - `pentestId` string, required — The unique identifier of the pentest.
    - `agentSpaceId` string, required — The unique identifier of the agent space that contains the pentest.
    - `title` string, required — The title of the pentest.
    - `createdAt` string, date-time — The date and time the pentest was created, in UTC format.
    - `updatedAt` string, date-time — The date and time the pentest was last updated, in UTC format.
  - `nextToken` string — A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request. For subsequent calls, use the nextToken value returned from the previous request.

---

[API](https://skmtc.net/aws/apis/securityagent.md) · [All operations](https://skmtc.net/aws/apis/securityagent/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/securityagent/versions/cad56717d636/schema)