Amazon Bedrock AgentCore Control

2026/02/05 - Amazon Bedrock AgentCore Control - 4 new api methods

Changes  Support Browser profile persistence (cookies and local storage) across sessions for AgentCore Browser.

DeleteBrowserProfile (new) Link ¶

Deletes a browser profile.

See also: AWS API Documentation

Request Syntax

client.delete_browser_profile(
    profileId='string',
    clientToken='string'
)
type profileId:

string

param profileId:

[REQUIRED]

The unique identifier of the browser profile to delete.

type clientToken:

string

param clientToken:

A unique, case-sensitive identifier to ensure idempotency of the request.

This field is autopopulated if not provided.

rtype:

dict

returns:

Response Syntax

{
    'profileId': 'string',
    'profileArn': 'string',
    'status': 'READY'|'DELETING'|'DELETED'|'SAVING',
    'lastUpdatedAt': datetime(2015, 1, 1),
    'lastSavedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • profileId (string) --

      The unique identifier of the deleted browser profile.

    • profileArn (string) --

      The Amazon Resource Name (ARN) of the deleted browser profile.

    • status (string) --

      The current status of the browser profile deletion.

    • lastUpdatedAt (datetime) --

      The timestamp when the browser profile was last updated.

    • lastSavedAt (datetime) --

      The timestamp when browser session data was last saved to this profile before deletion.

ListBrowserProfiles (new) Link ¶

Lists all browser profiles in your account.

See also: AWS API Documentation

Request Syntax

client.list_browser_profiles(
    maxResults=123,
    nextToken='string'
)
type maxResults:

integer

param maxResults:

The maximum number of results to return in the response.

type nextToken:

string

param nextToken:

A token to retrieve the next page of results.

rtype:

dict

returns:

Response Syntax

{
    'profileSummaries': [
        {
            'profileId': 'string',
            'profileArn': 'string',
            'name': 'string',
            'description': 'string',
            'status': 'READY'|'DELETING'|'DELETED'|'SAVING',
            'createdAt': datetime(2015, 1, 1),
            'lastUpdatedAt': datetime(2015, 1, 1),
            'lastSavedAt': datetime(2015, 1, 1),
            'lastSavedBrowserSessionId': 'string',
            'lastSavedBrowserId': 'string'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • profileSummaries (list) --

      The list of browser profile summaries.

      • (dict) --

        Contains summary information about a browser profile. A browser profile stores persistent browser data that can be reused across browser sessions.

        • profileId (string) --

          The unique identifier of the browser profile.

        • profileArn (string) --

          The Amazon Resource Name (ARN) of the browser profile.

        • name (string) --

          The name of the browser profile.

        • description (string) --

          The description of the browser profile.

        • status (string) --

          The current status of the browser profile. Possible values include READY, SAVING, DELETING, and DELETED.

        • createdAt (datetime) --

          The timestamp when the browser profile was created.

        • lastUpdatedAt (datetime) --

          The timestamp when the browser profile was last updated.

        • lastSavedAt (datetime) --

          The timestamp when browser session data was last saved to this profile.

        • lastSavedBrowserSessionId (string) --

          The identifier of the browser session from which data was last saved to this profile.

        • lastSavedBrowserId (string) --

          The identifier of the browser from which data was last saved to this profile.

    • nextToken (string) --

      A token to retrieve the next page of results.

CreateBrowserProfile (new) Link ¶

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.

See also: AWS API Documentation

Request Syntax

client.create_browser_profile(
    name='string',
    description='string',
    clientToken='string',
    tags={
        'string': 'string'
    }
)
type name:

string

param name:

[REQUIRED]

The name of the browser profile. The name must be unique within your account and can contain alphanumeric characters and underscores.

type description:

string

param description:

A description of the browser profile. Use this field to describe the purpose or contents of the profile.

type clientToken:

string

param clientToken:

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.

This field is autopopulated if not provided.

type tags:

dict

param tags:

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.

  • (string) --

    • (string) --

rtype:

dict

returns:

Response Syntax

{
    'profileId': 'string',
    'profileArn': 'string',
    'createdAt': datetime(2015, 1, 1),
    'status': 'READY'|'DELETING'|'DELETED'|'SAVING'
}

Response Structure

  • (dict) --

    • profileId (string) --

      The unique identifier of the created browser profile.

    • profileArn (string) --

      The Amazon Resource Name (ARN) of the created browser profile.

    • createdAt (datetime) --

      The timestamp when the browser profile was created.

    • status (string) --

      The current status of the browser profile.

GetBrowserProfile (new) Link ¶

Gets information about a browser profile.

See also: AWS API Documentation

Request Syntax

client.get_browser_profile(
    profileId='string'
)
type profileId:

string

param profileId:

[REQUIRED]

The unique identifier of the browser profile to retrieve.

rtype:

dict

returns:

Response Syntax

{
    'profileId': 'string',
    'profileArn': 'string',
    'name': 'string',
    'description': 'string',
    'status': 'READY'|'DELETING'|'DELETED'|'SAVING',
    'createdAt': datetime(2015, 1, 1),
    'lastUpdatedAt': datetime(2015, 1, 1),
    'lastSavedAt': datetime(2015, 1, 1),
    'lastSavedBrowserSessionId': 'string',
    'lastSavedBrowserId': 'string'
}

Response Structure

  • (dict) --

    • profileId (string) --

      The unique identifier of the browser profile.

    • profileArn (string) --

      The Amazon Resource Name (ARN) of the browser profile.

    • name (string) --

      The name of the browser profile.

    • description (string) --

      The description of the browser profile.

    • status (string) --

      The current status of the browser profile.

    • createdAt (datetime) --

      The timestamp when the browser profile was created.

    • lastUpdatedAt (datetime) --

      The timestamp when the browser profile was last updated.

    • lastSavedAt (datetime) --

      The timestamp when browser session data was last saved to this profile.

    • lastSavedBrowserSessionId (string) --

      The identifier of the browser session from which data was last saved to this profile.

    • lastSavedBrowserId (string) --

      The identifier of the browser from which data was last saved to this profile.