---
title: "PATCH /v1/agentspaces/{agentSpaceId}"
method: PATCH
path: "/v1/agentspaces/{agentSpaceId}"
---

# PATCH /v1/agentspaces/{agentSpaceId}

`PATCH /v1/agentspaces/{agentSpaceId}`

Updates the information of an existing AgentSpace.

## Path parameters

- `agentSpaceId` string, required — Unique identifier for an agent space (allows alphanumeric characters and hyphens; 1-64 characters)

## Request body

- object
  - `name` string — Agent space name field
  - `description` string, password — Description field
  - `locale` string — A BCP 47 locale identifier for configuring the language used in agent responses.

## Response `200`

Success

- UpdateAgentSpaceOutput — Output containing the updated AgentSpace.
  - `agentSpace` AgentSpace, required — Represents a complete AgentSpace with all its properties, timestamps, encryption settings, and unique identifier.
    - `name` string, required — The name of the AgentSpace.
    - `description` string, password — The description of the AgentSpace.
    - `locale` string — The locale for the AgentSpace, which determines the language used in agent responses.
    - `createdAt` string, date-time, required — The timestamp when the resource was created.
    - `updatedAt` string, date-time, required — The timestamp when the resource was last updated.
    - `kmsKeyArn` string — The ARN of the AWS Key Management Service (AWS KMS) customer managed key that's used to encrypt resources.
    - `agentSpaceId` string, required — The unique identifier of the AgentSpace

## Other responses

- `480` — ValidationException
- `481` — ContentSizeExceededException
- `482` — ServiceQuotaExceededException
- `483` — ConflictException
- `484` — InternalServerException
- `485` — AccessDeniedException
- `486` — ResourceNotFoundException
- `487` — ThrottlingException
- `488` — InvalidParameterException

---

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