Account, access and your data

Where do you manage your account?

Open Settings in the dashboard. Each tab covers one topic:

How do you change your profile and password?

• Profile: your name and email address. Serpel uses them for sign-in and in reports.
• Password: at least 12 characters. When you change it, every other session is signed out.
• Sign-in methods: sign in with Google using the email address of your account, and Google is linked automatically. You can unlink it once the account has a password, and then sign in with email address and password.
• Accounts created with Google have no password at first. To set one, confirm it is you with a fresh Google sign-in, or let Serpel email you a link.

From the command line, serpel auth profile changes name and email address. It needs a token with full access and no project restriction, which is what the device login of serpel auth login creates by default.

How do API tokens work?

An API token starts with vsk_ and gives the CLI and the REST API access to your account. Create one under Settings → API tokens with the Token button. The dialog asks for:

• Name: something that tells you later where the token is used, for example “CLI on laptop”.
• Permissions: all 18 scopes are selected by default. Untick everything the token doesn’t need. The REST API reference lists each scope.
• Projects: “All my projects” or a single project. A token for one project gets HTTP 404 for every other project.
• Expiry: never, 30 days, 90 days or 1 year.

The token is shown exactly once. Serpel stores only a hash, so copy it right away. Managing tokens from the CLI or the API needs a token with full access, as the device login creates it. Through the CLI or the API you can also restrict a token to up to 100 projects and pick any expiry from 1 to 365 days. A revoked token stops working immediately.

serpel tokens create --name "Nightly crawl" --scope audit:write --scope audit:read --expires-in-days 90
serpel tokens list
serpel tokens revoke <id> --yes

Who can access a project?

Access is set per project, not per account. Whoever creates a project is its owner and pays for its checks from their workspace. Other people can be added as viewer or editor:

During the beta, only the Serpel team can add members to a project, and only people who already have an activated Serpel account. The projects guide covers the roles and project settings in detail.

How do you export your data?

Under Settings → Profile and password → Data and account, Export account data has a Download JSON button. The file holds your profile, workspace, projects, integrations and links to the project exports. Credentials are not included. The export is only available in the dashboard, an API token gets HTTP 403.

Issues, keywords, rankings and tasks of a project export as CSV or JSON, as described in history and exports.

How do you delete your account?

The deletion also closes your customer record at Stripe, which ends a running subscription, and revokes Serpel’s access to a connected Google account. The credit ledger and payment records stay for accounting, without your name or projects. Export your data first if you want to keep it.

Where to go next