This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Note

: This feature is available in Enterprise, AWS, and Team editions only.

Table of contents

• How to generate API token
• How to delete API token
• Using the API token with GraphQL

The CloudBeaver allows you to generate API tokens for automating tasks and interacting with the GraphQL API.

Note

: Each user must create their own tokens.

How to generate API token

1. Enable the API token switch in Settings -> Administration -> Server configuration -> Authentication settings.

2. Navigate to your Profile page in the CloudBeaver.

3. Open the API Token tab.

   

4. Click + Add.

   Note

   : Users can create up to 5 tokens.

5. Choose Name and Expiration period. You can choose from options like 1 day, 1 week, 1 moth, 1 year, or no expiration (not recommended for security reasons).

6. Copy the token after it’s generated.

   Important: Tokens are displayed only once during creation.

How to delete API token

1. On the API Token tab.

2. Find the token you want to delete and click the Delete icon.

3. Confirm the deletion in the confirmation dialog.

Note

effect.

Using the API token with GraphQL

Authenticate with the GraphQL API console using your token by including it in the query.

• Example query:

query authLogin($credentials: Object) {
  authLogin(
    provider: "token"
    credentials: $credentials
  ) {
    authId
    userTokens {
      userId
    }
    authStatus
  }
}

• Variables:

{
  "credentials": {
    "token": "your_api_token_here"
  }
}

• Example response: