---
title: "PUT /browser-profiles"
method: PUT
path: "/browser-profiles"
---

# PUT /browser-profiles

`PUT /browser-profiles`

Creates a browser profile in Amazon Bedrock AgentCore. A browser profile stores persistent browser data such as cookies, local storage, session storage, and browsing history that can be saved from browser sessions and reused in subsequent sessions.

## Request body

- object
  - `name` string, required — The name of the browser profile. The name must be unique within your account and can contain alphanumeric characters and underscores.
  - `description` string, password — A description of the browser profile. Use this field to describe the purpose or contents of the profile.
  - `clientToken` string — A unique, case-sensitive identifier to ensure that the operation completes no more than one time. If this token matches a previous request, Amazon Bedrock AgentCore ignores the request but does not return an error.
  - `tags` object — A map of tag keys and values to assign to the browser profile. Tags enable you to categorize your resources in different ways, for example, by purpose, owner, or environment.

## Response `200`

Success

- CreateBrowserProfileResponse
  - `profileId` string, required — The unique identifier of the created browser profile.
  - `profileArn` string, required — The Amazon Resource Name (ARN) of the created browser profile.
  - `createdAt` string, date-time, required — The timestamp when the browser profile was created.
  - `status` 'READY' | 'DELETING' | 'DELETED' | 'SAVING', required — The current status of the browser profile.

## Other responses

- `480` — ServiceQuotaExceededException
- `481` — AccessDeniedException
- `482` — ConflictException
- `483` — ValidationException
- `484` — ThrottlingException
- `485` — InternalServerException

---

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