API Tokens

Overview

API tokens provide programmatic access to the VibeView REST API. Use them to upload apps, retrieve session data, or generate reports from CI/CD pipelines and scripts.

Features

• Token list — A table showing all tokens for your organisation with columns for label, masked token prefix, usage status (used / never used), creator email, and assigned role.
• Token creation — Organisation admins can generate new tokens with a custom label and role (Developer or Admin).
• One-time display — The full token value is shown exactly once at creation time. It cannot be retrieved later.
• Token deletion — Remove tokens that are no longer needed. Any integration using a deleted token will immediately lose access.

How to Create a Token

Creating (and deleting) tokens requires the Admin role.

1. Navigate to Settings > API Token.
2. Click Generate API Token.
3. Enter a descriptive Label (e.g., “CI Pipeline” or “Staging Deploy”).
4. Select a Role for the token — this determines what API endpoints the token can access.
   • Developer — Can manage apps, view sessions, and run tests.
   • Admin — Full access including billing and team management endpoints.
5. Click Generate Token.
6. Copy the displayed token immediately — it will not be shown again.
7. Click Copy Token to place it on your clipboard.

How to Delete a Token

1. In the token table, click the trash icon on the row of the token you want to remove.
2. A confirmation dialog warns that integrations using this token will stop working.
3. Click Delete Token to confirm.

Permissions