# Open API

Manage MoreLogin browser profiles and cloud browser runtimes remotely through the MoreLogin Open API.

**Base URL**: `https://api.morelogin.com`

The Open API manages the same browser profiles as the Local API, but it does not require the
MoreLogin desktop client. Because no local client is involved, the Open API cannot launch a browser
on your own machine. Instead, it can start the profile as a **cloud runtime** that runs on
MoreLogin infrastructure and is driven over the Chrome DevTools Protocol (CDP).

| Capability | Local API | Open API |
| --- | --- | --- |
| Manage profiles, proxies, groups, tags | Yes | Yes |
| Launch the browser on your own machine | Yes | No |
| Launch the browser in the MoreLogin cloud | Yes | Yes |

**ID encoding**: MoreLogin IDs are 64-bit integers on the server, but they are serialized in JSON as
decimal strings to avoid precision loss in JavaScript. Send them as strings and read them as strings.

Authentication uses an OAuth2 Bearer token. See
[Authentication](../Getting%20Started/authentication.md) for details.


Version: 1.0.0

## Servers

MoreLogin Open API endpoint
```
https://api.morelogin.com
```

## Security

### OpenApiBearer

[object Object]

Type: http
Scheme: bearer
Bearer Format: JWT

## Download OpenAPI description

 - [Open API](https://guide.morelogin.com/_bundle/@l10n/es/API%20Reference/Browser/open-api.yaml)

## Profiles

 - [POST /env/create/quick](https://guide.morelogin.com/es/api-reference/browser/open-api/profiles/quickcreatebrowserprofileopenapi.md): Create 1 to 200 browser profiles that share the same configuration. The browser kernel is selected from published kernels based on `operatorSystemId`. No client information is used, so you can optiona
 - [POST /env/create/advanced](https://guide.morelogin.com/es/api-reference/browser/open-api/profiles/advancedcreatebrowserprofileopenapi.md): Create a single browser profile with a full fingerprint configuration. The browser kernel is matched from published kernels using the operating system and kernel fields in the request. No client vers
 - [POST /env/update](https://guide.morelogin.com/es/api-reference/browser/open-api/profiles/updatebrowserprofileopenapi.md): Update an existing browser profile. Only the fields present in the request are changed. When the kernel has to be re-matched, the operating system already stored on the profile is used. No client ope
 - [POST /env/page](https://guide.morelogin.com/es/api-reference/browser/open-api/profiles/listbrowserprofilesopenapi.md): Query the browser profiles visible to the authenticated member, page by page. Paging starts at 1. `dataList` is an empty array when there are no results.
 - [POST /env/detail](https://guide.morelogin.com/es/api-reference/browser/open-api/profiles/getbrowserprofiledetailopenapi.md): Return the full configuration of a single browser profile.
 - [POST /env/removeToRecycleBin/batch](https://guide.morelogin.com/es/api-reference/browser/open-api/profiles/batchremovebrowserprofilesopenapi.md): Move one or more browser profiles to the recycle bin.
 - [POST /env/lock/query](https://guide.morelogin.com/es/api-reference/browser/open-api/profiles/querybrowserprofilelockopenapi.md): Check whether a browser profile is currently locked by another member.
 - [POST /env/setGroup/batch](https://guide.morelogin.com/es/api-reference/browser/open-api/profiles/batchsetbrowserprofilegroupopenapi.md): Move profiles into a group by group name. The group is created automatically when it does not exist. Provide at least one of `envIds` or `uniqueIds`.
 - [POST /env/setProxy/batch](https://guide.morelogin.com/es/api-reference/browser/open-api/profiles/batchsetbrowserprofileproxyopenapi.md): Bind a proxy to multiple profiles. When `proxyId` matches an existing proxy, the profiles are bound to it; otherwise a new proxy is created from the supplied connection details. Provide at least one o
 - [POST /env/setRemark/batch](https://guide.morelogin.com/es/api-reference/browser/open-api/profiles/batchsetbrowserprofileremarkopenapi.md): Set the remark on multiple profiles. Pass an empty string to clear the remark. Provide at least one of `envIds` or `uniqueIds`.
## Cloud Runtime

 - [POST /cloudbrowser/start](https://guide.morelogin.com/es/api-reference/browser/open-api/cloud-runtime/startcloudruntimeopenapi.md): Start a browser profile as a cloud runtime. Starting is asynchronous. A successful response only means the start request was accepted. Poll [Page cloud runtimes](#operation/pageCloudRuntimesOpenApi) u
 - [POST /cloudbrowser/stop](https://guide.morelogin.com/es/api-reference/browser/open-api/cloud-runtime/stopcloudruntimeopenapi.md): Stop the active cloud runtime for a profile. A successful response only means the stop request was accepted; archiving and resource release may still be in progress. `force` is only honored when the c
 - [POST /cloudbrowser/page](https://guide.morelogin.com/es/api-reference/browser/open-api/cloud-runtime/pagecloudruntimesopenapi.md): Query the browser profiles visible to the authenticated member together with the cloud runtime status for that member. `envId` also accepts the field alias `id`. `groupId` of `0` means ungrouped.
 - [POST /cloudbrowser/connect](https://guide.morelogin.com/es/api-reference/browser/open-api/cloud-runtime/connectcloudruntimeopenapi.md): Return the connection details for a running cloud runtime. Attach an automation framework such as Puppeteer, Playwright, or Selenium to the returned `cdpUrl`. The runtime must be in the `RUNNING` stat
## Fingerprint & Device Config

 - [POST /env/advanced/ua/versions](https://guide.morelogin.com/es/api-reference/browser/open-api/fingerprint-and-device-config/listkernelversionsopenapi.md): Return the published browser kernel and UA major versions. The request body is optional and every field is optional. Defaults are Windows (`1`), 64-bit (`1`), and x86 (`0`). Only published kernels are
 - [POST /env/advanced/ua/get](https://guide.morelogin.com/es/api-reference/browser/open-api/fingerprint-and-device-config/getuseragentopenapi.md): Generate a user agent that matches the requested operating system and browser vendor, using only published kernels.
 - [POST /env/base/resolution/list](https://guide.morelogin.com/es/api-reference/browser/open-api/fingerprint-and-device-config/listresolutionsopenapi.md): Return the resolutions available for a user agent or operating system.
 - [POST /env/base/list](https://guide.morelogin.com/es/api-reference/browser/open-api/fingerprint-and-device-config/listtimezonesandlanguagesopenapi.md): Return the time zones and languages available for an operating system.
 - [POST /env/base/mobile/devices](https://guide.morelogin.com/es/api-reference/browser/open-api/fingerprint-and-device-config/listmobiledevicesopenapi.md): Return the mobile device models available for Android and iOS profiles. No request body.
 - [POST /env/fingerprint/refresh](https://guide.morelogin.com/es/api-reference/browser/open-api/fingerprint-and-device-config/refreshfingerprintopenapi.md): Regenerate the fingerprint of a profile. Provide at least one of `envId` or `uniqueId`. The operating system in the request takes precedence; when it is omitted, the operating system stored on the pro
## Cache

 - [POST /env/cache/cleanCloud](https://guide.morelogin.com/es/api-reference/browser/open-api/cache/cleancloudcacheopenapi.md): Clear the cloud-side cache of a profile. This does not touch any local client cache. Provide at least one of `envId` or `uniqueId`.