ogma projects Help
Open ogma

Your account

Your account — display name, theme preference, and API tokens — lives on the shared account service. Open the avatar menu in the top-right and choose Profile to manage it there (the workspace portal's /profile page); when you're done, head back to ogma (the session is shared).

The account page: an Identity card with display name and avatar URL fields, a Theme card offering Light, Dark and System, and an API tokens card listing tokens with their scopes and Revoke buttons. The account page: an Identity card with display name and avatar URL fields, a Theme card offering Light, Dark and System, and an API tokens card listing tokens with their scopes and Revoke buttons.

Profile

  • Display name — how you appear to others (on cards, comments, mentions). You can change it any time on the account service.
  • Email — your sign-in identity. It's shown for reference and can't be changed there; ask an administrator if it needs updating.

Theme

ogma has a light and a dark theme. Switch instantly with the sun/moon button in the top-right of any page — the preference is saved to your account, so it follows you. On the account service you can also pick:

  • Light or Dark — always use that theme.
  • System — follow your device's setting.

API tokens

Tokens let scripts and integrations act as you through the JSON API. They're managed on the account service:

  • Under API tokens, choose Create token and give it a name.
  • The token is shown once — copy it immediately and store it somewhere safe. You can't view it again.
  • A token carries your permissions. Treat it like a password.
  • Revoke a token any time from the same list; it stops working at once.

Use a token with an Authorization: Bearer <token> header — see The API.