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

# POST /BatchGetThreatModelJobs

`POST /BatchGetThreatModelJobs`

Retrieves information about one or more threat model jobs in an agent space.

## Request body

- object
  - `threatModelJobIds` String[], required — List of threat model job IDs.
  - `agentSpaceId` string, required — The unique identifier of the agent space that contains the threat model jobs.

## Response `200`

Success

- BatchGetThreatModelJobsOutput — Output for the BatchGetThreatModelJobs operation.
  - `threatModelJobs` ThreatModelJob[] — The list of threat model jobs that were found.
    - `threatModelJobId` string — The unique identifier of the threat model job.
    - `threatModelId` string — The unique identifier of the threat model associated with the job.
    - `agentSpaceId` string — The unique identifier of the agent space.
    - `title` string — The title of the threat model job.
    - `status` 'IN_PROGRESS' | 'STOPPING' | 'STOPPED' | 'FAILED' | 'COMPLETED' — The current status of the threat model job.
    - `createdAt` string, date-time — The date and time the threat model job was created, in UTC format.
    - `updatedAt` string, date-time — The date and time the threat model job was last updated, in UTC format.
    - `executionStartTime` string, date-time — The date and time the threat model job execution started, in UTC format.
    - `executionEndTime` string, date-time — The date and time the threat model job execution ended, in UTC format.
    - `sourceCode` SourceCodeRepository[] — The list of source code repositories used for threat modeling.
      - `s3Location` string — The Amazon S3 location of the source code repository archive.
    - `integratedRepositories` IntegratedRepository[] — The list of integrated repositories used for threat modeling.
      - `integrationId` string, required — The unique identifier of the integration that provides access to the repository.
      - `providerResourceId` string, required — The provider-specific resource identifier for the repository.
    - `documents` DocumentInfo[] — The list of documents used for threat modeling.
      - `s3Location` string — The Amazon S3 location of the document.
      - `artifactId` string — The unique identifier of the artifact associated with the document.
      - `integratedDocument` object — A reference to a document in an integrated third-party provider.
        - `integrationId` string, required — The identifier of the integration that provides access to the document.
        - `resourceId` string, required — The provider-specific resource identifier for the document.
    - `scopeDocs` DocumentInfo[] — The scoped documents for the agent to focus on during threat modeling.
      - `s3Location` string — The Amazon S3 location of the document.
      - `artifactId` string — The unique identifier of the artifact associated with the document.
      - `integratedDocument` object — A reference to a document in an integrated third-party provider.
        - `integrationId` string, required — The identifier of the integration that provides access to the document.
        - `resourceId` string, required — The provider-specific resource identifier for the document.
    - `errorInformation` object — Error information if the threat model job encountered an error.
      - `code` 'CLIENT_ERROR' | 'INTERNAL_ERROR' | 'STOPPED_BY_USER' — The error code. Valid values include CLIENT_ERROR, INTERNAL_ERROR, and STOPPED_BY_USER.
      - `message` string — A message describing the error.
    - `systemOverview` string — The system overview generated during threat modeling.
  - `notFound` String[] — The list of threat model job identifiers that were not found.

---

[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/revisions/cad56717d636/schema)