Skip to content

Account and API tokens

Your profile page is your account hub. It shows your ORCID profile, your remaining quota, your recent jobs, and lets you manage API tokens.

Your profile

  1. Open the account menu in the navbar, next to your name, and choose Profile.

    Profile page with account info, quota and recent jobs

  2. From here you can:

    • view your account details and quota,
    • generate or revoke an API token,
    • review your recent jobs with quick links,
    • change your display preferences,
    • delete your account and all locally stored data.

Generate an API token

API tokens let you use the Malva search API from scripts and notebooks without going through the browser login.

  1. Go to your profile and find the API token section.

  2. Click Generate token. A new token starting with malva_ is shown once.

    API token generation on the profile page

  3. Copy it and store it in a safe place. For security, it is not shown again.

  4. Use it either to sign in on the login page or as a Bearer header:

    curl -H "Authorization: Bearer malva_..." https://malva.mdc-berlin.de/api/...

Revoke a token

If a token is compromised or no longer needed, revoke it from the same section on your profile. Revocation takes effect immediately for new requests.

Tokens are secret

Treat your token like a password. Do not commit it to version control or paste it into notebooks you share publicly.