For AI agents: a documentation index is available at /llms.txt
Skip to main content

/profile

DELETE 

/profile

Removes selected sites and their cookies, localStorage and IndexedDB from a saved profile.

Note: This endpoint is also available at: /management/profile for backwards compatibility.

Request​

Body

    namestringrequired
    domainsstring[]required

    Exact sites to remove, without cascading to subdomains.

Responses​

Schema
    idstringrequired

    Unique profile identifier.

    namestringrequired

    User-supplied profile name. Unique per token.

    cookieCountnumberrequired

    Number of cookies captured in the profile.

    originCountnumberrequired

    Number of distinct origins with stored localStorage or IndexedDB.

    captureSettings objectrequired

    Capture inputs the CLI used, or null for profiles not created by the CLI. The UI derives no capture flag from these; it uses any non-empty object to stamp the CLI badge and show a read-only summary, and reads browser/profile specifically to decide whether its refresh command needs placeholders for them. The CLI reads the rest itself and decides the exclusion behaviour from excludeDomains.

    browserstring

    Raw --browser value.

    profilestring

    Raw --profile value (source profile directory or display name).

    excludeDomainsstring[]

    Effective merged exclusion list. [] is meaningful — "captured with no exclusions" — and distinct from absent, which means "unknown".

    onlyDomainsstring[]

    Normalized --only-domain hostnames, deduped and capped — not merged with local config.

    keepDomainsstring[]

    Normalized --keep-domain hostnames, same normalization, no merge.

    autoFitboolean

    Whether --auto-fit was used.

    passwordStorestring

    Raw --password-store value. Linux only.

    cliVersionstring

    CLI version that produced these settings, for drift diagnosis.

    domainAuth object[]required

    Per-domain auth status + expiry for the saved logins in this profile, with status classified at read time (valid / expiring_soon / expired / unknown). Empty for profiles saved before this feature, until their next capture, upload, or refresh. Never contains a cookie value.

  • Array [
  • domainstringrequired
    statusDomainAuthStatusrequired

    Per-domain auth status, computed at read time from a stored absolute expiry.

    Possible values: [expired, expiring_soon, unknown, valid]

    expiresAtstringrequired
  • ]
  • lastUsedAtstringrequired

    ISO timestamp of the last time this profile was applied to a session, or null if never used.

    createdAtstringrequired

    ISO timestamp of when the profile was created.

    updatedAtstringrequired

    ISO timestamp of the last metadata change (e.g., rename).

Was this page helpful?