Api

To integrate Alviss AI into your existing systems, we provide a comprehensive API. The full API documentation is available at here.

Authentication

All API requests require authentication using an access token. For details on creating an access token, refer to the Create Access Token section below.

Once you have your access token, include it in the Authorization header of your requests as a Bearer token. Here's an example using curl (replace YOUR-TOKEN with your actual token):

curl --request GET \
  --url "https://api.alviss.io/v1/team/teams" \
  --header "Authorization: Bearer YOUR-TOKEN" \
  --header "Accept: application/json"

Managing Access Tokens

You can manage your access tokens by navigating to https://app.alviss.io/-/user#access-tokens. Alternatively, click on your profile picture in the top-right corner of the Alviss AI platform, select Your Account from the menu, and then go to the Access Tokens tab.

Create Access Token

1. Click the Create New Token button.

2. In the modal that appears, fill in the following fields:

   • Name: A descriptive name for your token (e.g., "Integration Token").
   • Expires At: The expiration date and time for the token. For security, set an expiration that aligns with your needs—we recommend limiting it to when your task is complete. Tokens can expire up to 365 days from creation.

3. Submit the form. Your new access token will be displayed only once—copy and store it securely immediately, as it will not be visible again after closing the modal.

Revoke Access Token

To revoke a token, locate it in the list of access tokens and click the Revoke button next to it. This immediately invalidates the token, preventing further use.