# CfnAgentSpaceProps

Properties for defining a `CfnAgentSpace`.

Extends: CfnAgentSpaceProps
Used as props by: CfnAgentSpace

- Source: Generated code
- Type last changed: v2.272.0 · 30 Sep 2026

## Example

```ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_devopsagent as devopsagent } from 'aws-cdk-lib';
const cfnAgentSpaceProps: devopsagent.CfnAgentSpaceProps = {
  name: 'name',

  // the properties below are optional
  description: 'description',
  kmsKeyArn: 'kmsKeyArn',
  locale: 'locale',
  operatorApp: {
    iam: {
      operatorAppRoleArn: 'operatorAppRoleArn',

      // the properties below are optional
      createdAt: 'createdAt',
      updatedAt: 'updatedAt',
    },
    idc: {
      idcInstanceArn: 'idcInstanceArn',
      operatorAppRoleArn: 'operatorAppRoleArn',

      // the properties below are optional
      createdAt: 'createdAt',
      idcApplicationArn: 'idcApplicationArn',
      updatedAt: 'updatedAt',
    },
    idp: {
      clientId: 'clientId',
      clientSecret: 'clientSecret',
      issuerUrl: 'issuerUrl',
      operatorAppRoleArn: 'operatorAppRoleArn',
      provider: 'provider',

      // the properties below are optional
      createdAt: 'createdAt',
      updatedAt: 'updatedAt',
      userIdClaim: 'userIdClaim',
    },
  },
  preferences: {
    elevatedActionsEnabled: false,
  },
  tags: [{
    key: 'key',
    value: 'value',
  }],
};
```

## Properties

- `description`: string — The description of the Agent Space.

- `kmsKeyArn`: string — The ARN of the KMS key to use for encryption.

- `locale`: string — The locale for the AgentSpace, which determines the language used in agent responses.

- `name`: string (required) — The name of the Agent Space.

- `operatorApp`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnAgentSpace.OperatorAppProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_devopsagent.CfnAgentSpace.OperatorAppProperty.html)

- `preferences`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnAgentSpace.PreferencesProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_devopsagent.CfnAgentSpace.PreferencesProperty.html) — Preferences that configure behavior of this AgentSpace.

  This container fully owns the AgentSpace preferences: the properties supplied here replace the stored preferences in their entirety, and omitting the Preferences container reverts all preferences to their service defaults.

- `tags`: [CfnTag](/cdk/api/v2/docs/aws-cdk-lib.CfnTag.html)[] — An array of key-value pairs to apply to this resource.