Cosmic Logo

Account

Learn about the features of your Cosmic account.

Creating an account

Create your free Cosmic account by going to https://app.cosmicjs.com/signup.

Account settings

Click your avatar in the main navigate and follow the link to account settings.

Account image

In the account settings view, you can update the following:

  1. Avatar
  2. First and last name
  3. Email address
  4. Password

Billing details

Go to Account settings > Billing details to update your billing information.

Billing details image

Invoices

Once invoices are available for you to view, you can go to Account settings > Invoices to view prior invoices.

Invoices image

Two-factor authentication

Go to Account settings > Two-factor authentication to add two-factor authentication (2FA) to your account. 2FA is an added layer of security which, once activated, will require you to input a code generated from text message to log in to your account.

2FA code image

Saved Authentications

Go to Account settings > Saved Authentications to manage browser sessions for Computer Use Agents. Saved authentications let you capture and reuse login sessions so your agents can access protected sites without re-authenticating each time.

How it works

  1. Click "Add Authentication" and enter the URL of the site you want to authenticate with (e.g., https://github.com)
  2. A browser window opens for you to log in normally. You can open multiple tabs to log into different services in the same session
  3. Complete any verifications (2FA, CAPTCHA, etc.), then close the browser window
  4. Your session (cookies, localStorage) is encrypted and saved to your account

Using saved authentications

When creating or editing a Computer Use Agent or workflow step, the Pre-Authentication section shows your saved authentications under "Use Saved Authentication". Select one or more to pre-load those sessions into the agent's browser before it starts.

You can also use saved authentications alongside manually captured sessions. The agent merges all authentication data before execution.

Managing saved authentications

From the Saved Authentications settings page you can:

  • Edit the label of any saved authentication
  • Delete authentications you no longer need
  • View usage to see which agents and workflows reference a credential before deleting

Security

  • All session data is encrypted at rest using AES-256 encryption
  • Sessions are scoped to your user account and cannot be accessed by other users
  • Deleting a saved authentication removes it from all agents and workflows that reference it

API Tokens

Go to Account Settings > API Tokens to create and manage Personal Access Tokens (PATs) for programmatic API access.

What are API Tokens?

API Tokens let you authenticate with the Cosmic API from scripts, CI/CD pipelines, the Cosmic CLI, MCP Server, or any external application. Tokens carry the same permissions as your account and use the cos_ prefix for easy identification.

Creating a token

  1. Go to Account Settings > API Tokens
  2. Click "Create Token"
  3. Enter a descriptive name (e.g., "CI/CD Pipeline", "MCP Server", "CLI")
  4. Choose an expiration period (30 days, 60 days, 90 days, 1 year, or no expiration)
  5. Click "Create"

The token is displayed once after creation. Copy it immediately and store it securely. You will not be able to see it again.

Using a token

Include your token in the Authorization header of API requests:

curl https://dapi.cosmicjs.com/v3/users/get \
  -H "Authorization: Bearer cos_YOUR_TOKEN"

Managing tokens

From the API Tokens settings page you can:

  • Edit the name of any token
  • Delete tokens you no longer need (applications using a deleted token will lose access immediately)
  • View last used to see when a token was last used for authentication

Security

  • Tokens are hashed with SHA-256 before storage. Cosmic never stores the plain token.
  • Tokens carry your full account permissions. Treat them like passwords.
  • Use short expiration periods for tokens used in less secure environments.
  • Delete tokens you are no longer using.

Light / dark mode

The dashboard will default to your system preferences for either light or dark mode. To override this, you can click your avatar to show the dropdown and toggle to either theme. This can also be done via the search modal.

Theme image