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

/profile/*

GET 

/profile/*

Returns metadata for a specific authentication profile. The profile name is the URL-encoded path segment after "/profile/". Returns 404 if no profile with that name exists for this token.

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

Request​

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?