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

# POST /BatchGetAgentSpaces

`POST /BatchGetAgentSpaces`

Retrieves information about one or more agent spaces.

## Request body

- object
  - `agentSpaceIds` AgentSpaceId[], required — The list of agent space identifiers to retrieve.

## Response `200`

Success

- BatchGetAgentSpacesOutput — Output for the BatchGetAgentSpaces operation.
  - `agentSpaces` AgentSpace[] — The list of agent spaces that were found.
    - `agentSpaceId` string, required — The unique identifier of the agent space.
    - `name` string, required — The name of the agent space.
    - `description` string — A description of the agent space.
    - `awsResources` object — The AWS resources associated with the agent space.
      - `vpcs` VpcConfig[] — The VPC configurations associated with the agent space.
        - `vpcArn` string — The Amazon Resource Name (ARN) of the VPC.
        - `securityGroupArns` SecurityGroupArn[] — The Amazon Resource Names (ARNs) of the security groups for the VPC configuration.
        - `subnetArns` SubnetArn[] — The Amazon Resource Names (ARNs) of the subnets for the VPC configuration.
      - `logGroups` LogGroupArn[] — The Amazon Resource Names (ARNs) of the CloudWatch log groups associated with the agent space.
      - `s3Buckets` S3BucketArn[] — The Amazon Resource Names (ARNs) of the S3 buckets associated with the agent space.
      - `secretArns` SecretArn[] — The Amazon Resource Names (ARNs) of the Secrets Manager secrets associated with the agent space.
      - `lambdaFunctionArns` LambdaFunctionArn[] — The Amazon Resource Names (ARNs) of the Lambda functions associated with the agent space.
      - `iamRoles` ServiceRole[] — The IAM roles associated with the agent space.
    - `targetDomainIds` String[] — The list of target domain identifiers associated with the agent space.
    - `codeReviewSettings` object — The code review settings for the agent space.
      - `controlsScanning` boolean, required — Indicates whether controls scanning is enabled for code reviews.
      - `generalPurposeScanning` boolean, required — Indicates whether general-purpose scanning is enabled for code reviews.
    - `kmsKeyId` string — The identifier of the AWS KMS key used to encrypt data in the agent space.
    - `createdAt` string, date-time — The date and time the agent space was created, in UTC format.
    - `updatedAt` string, date-time — The date and time the agent space was last updated, in UTC format.
  - `notFound` AgentSpaceId[] — The list of agent space 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/versions/cad56717d636/schema)