> ## Documentation Index
> Fetch the complete documentation index at: https://tbd-6fc993ce-hypeship-changelog-august-13.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# manage_profiles

> Set up, retrieve, rename, and delete browser profiles

Manage browser profiles that persist cookies, logins, and session data across browser sessions.

## Actions

| Action   | Description                                                    |
| -------- | -------------------------------------------------------------- |
| `setup`  | Create or update a profile with a guided live browser session. |
| `list`   | List all profiles.                                             |
| `get`    | Retrieve a profile by ID or exact name.                        |
| `rename` | Change a profile's name.                                       |
| `delete` | Remove a profile.                                              |

## Parameters

| Parameter         | Description                                                                                   |
| ----------------- | --------------------------------------------------------------------------------------------- |
| `action`          | Operation to perform: `setup`, `list`, `get`, `rename`, or `delete`. Required.                |
| `profile_name`    | (setup, get, rename, delete) Exact profile name. Names used for setup follow the rules below. |
| `profile_id`      | (get, rename, delete) Profile ID. Alternative to `profile_name`.                              |
| `new_name`        | (rename) New profile name. Follows the rules below.                                           |
| `update_existing` | (setup) If true, update an existing profile. Default false.                                   |
| `query`           | (list) Search profiles by name or ID.                                                         |
| `limit`           | (list) Maximum results per page. Must be between 1 and 100.                                   |
| `offset`          | (list) Pagination offset. Must be 0 or greater.                                               |

`profile_name` for setup and `new_name` for rename share the same rules: 1–255 characters using ASCII letters, numbers, dots, underscores, or hyphens; unique within the project; and not exactly 24 lowercase alphanumeric characters, which would be ambiguous with a profile ID.

Name-based setup uses an exact match. If more than one profile has the same name, rename or delete duplicate profiles by ID, then retry setup. With `update_existing: true`, setup fails instead of creating a profile when no exact match exists.

Do not rename a profile while a browser is using it. The active session may no longer be able to save changes back to that profile.

## Example

```json theme={null}
{
  "action": "setup",
  "profile_name": "work-accounts"
}
```