Braintrust
Visualize Braintrust users, groups, roles, API keys, service tokens, projects, prompts, datasets, and AI provider secrets, map group membership and role assignments to see who has access to what, track which models your prompts depend on, and monitor changes through queries and alerts.
- Installation
- Authorization
- Data Model
- Types
- Release Notes
Installation
You will need a Braintrust account with access to create API keys, and the key must be able to read your organization's resources. You must also have permission in JupiterOne to install new integrations.
Configuration in Braintrust
- Log in to your Braintrust account.
- Navigate to Settings > API keys.
- Click Create API key and give it a name, such as
JupiterOne Integration. - Copy the generated API key.
By default, the Braintrust API only returns API keys that belong to the authenticated user. To collect API keys for every user in your organization, make sure the API key owner has the Owner role on the organization, then turn on Enable Impersonation when you configure the integration in JupiterOne.
Configuration in JupiterOne
To install the Braintrust integration in JupiterOne, navigate to the Integrations tab in JupiterOne and select Braintrust. Click New Instance to begin configuring your integration.
Creating an instance requires the following:
-
The Account Name used to identify the Braintrust account in JupiterOne. Ingested entities will have this value stored in
tag.AccountNamewhen theAccountNametoggle is enabled. -
Description to assist in identifying the integration instance, if desired.
-
Polling Interval that you feel is sufficient for your monitoring needs. You may leave this as
DISABLEDand manually execute the integration. -
The API Key you created in Braintrust.
-
Enable Impersonation, optionally, to collect API keys for every user in the organization.
-
Click Create after all values are provided.
Next steps
Now that your integration instance has been configured, it will begin running on the polling interval you provided, populating data within JupiterOne. Continue on to our Instance management guide to learn more about working with and editing integration instances.
Roles
RBAC roles that must be assigned to the integration principal.
Show Roles (1)
Owner
Documentation Links
Links to provider documentation relevant to setup and configuration.
Show Documentation Links (1)
Per-Data-Source Breakdown
Authorization required by the steps that make up each data source. Steps that depend on a data source are listed in the Per-Step Breakdown; the complete lists are in the sections above.
Show all data sources (11)
| Data Source | Roles |
|---|---|
| Fetch Account | - |
| Fetch AI Secrets | - |
| Fetch Api Keys | Owner |
| Fetch Datasets | - |
| Fetch Groups | - |
| Fetch Project Providers | - |
| Fetch Projects | - |
| Fetch Prompts | - |
| Fetch Roles | - |
| Fetch Service Tokens | - |
| Fetch Users | - |
Per-Step Breakdown
Detailed authorization requirements for each ingestion step.
Show all steps (10)
| Step | Roles |
|---|---|
| Fetch AI Secrets | - |
| Fetch API Keys | Owner |
| Fetch Datasets | - |
| Fetch Groups | - |
| Fetch Project Providers | - |
| Fetch Projects | - |
| Fetch Prompts | - |
| Fetch Roles | - |
| Fetch Service Tokens | - |
| Fetch Users | - |
Entities
The following entities are created:
| Resources | Entity _type | Entity _class |
|---|---|---|
| Access Key | braintrust_api_key | AccessKey |
| Access Role | braintrust_role | AccessRole |
| Account | braintrust_account | Account |
| AI Secret | braintrust_ai_secret | Secret |
| Dataset | braintrust_dataset | DataStore |
| Environment Variable | braintrust_env_var | Configuration |
| Model | braintrust_model | Model |
| Project | braintrust_project | Project |
| Prompt | braintrust_prompt | Configuration |
| Service Token | braintrust_service_token | AccessKey |
| User | braintrust_user | User |
| User Group | braintrust_group | UserGroup |
Relationships
The following relationships are created:
Source Entity _type | Relationship _class | Target Entity _type |
|---|---|---|
braintrust_account | HAS | braintrust_user |
braintrust_account | HAS | braintrust_group |
braintrust_account | HAS | braintrust_role |
braintrust_account | HAS | braintrust_project |
braintrust_account | HAS | braintrust_api_key |
braintrust_account | HAS | braintrust_ai_secret |
braintrust_account | HAS | braintrust_service_token |
braintrust_group | HAS | braintrust_user |
braintrust_group | ASSIGNED | braintrust_role |
braintrust_project | HAS | braintrust_prompt |
braintrust_project | HAS | braintrust_dataset |
braintrust_project | HAS | braintrust_env_var |
braintrust_prompt | USES | braintrust_model |
braintrust_user | CREATED | braintrust_project |
braintrust_user | CREATED | braintrust_api_key |
braintrust_user | ASSIGNED | braintrust_role |
Braintrust Account
braintrust_account inherits from Account
| Property | Type | Description | Specifications |
|---|---|---|---|
accountId | string | The Braintrust organization ID |
Braintrust Ai Secret
braintrust_ai_secret inherits from Secret
| Property | Type | Description | Specifications |
|---|---|---|---|
previewSecret | string | Masked preview of the secret value | |
providerType | string | The AI provider type (e.g. anthropic, bedrock, openai) | |
updatedOn | number | Timestamp of the last update |
Braintrust Api Key
braintrust_api_key inherits from AccessKey
| Property | Type | Description | Specifications |
|---|---|---|---|
previewName | string | Preview hint of the API key value | |
userEmail | string | Email of the user who owns this key |
Braintrust Dataset
braintrust_dataset inherits from DataStore
Braintrust Env Var
braintrust_env_var inherits from Configuration
| Property | Type | Description | Specifications |
|---|---|---|---|
lastUsedOn | number | Timestamp of last usage | |
objectId | string | ID of the scoped object | |
objectType | string | Scope type: organization, project, or function | |
secretCategory | string | Category: env_var, ai_provider, or sandbox_provider | |
secretType | string | The AI provider type name |
Braintrust Group
braintrust_group inherits from UserGroup
| Property | Type | Description | Specifications |
|---|---|---|---|
memberGroupCount | number | Number of sub-groups in this group | |
memberUserCount | number | Number of users in this group |
Braintrust Model
braintrust_model inherits from Model
Braintrust Project
braintrust_project inherits from Project
Braintrust Prompt
braintrust_prompt inherits from Configuration
| Property | Type | Description | Specifications |
|---|---|---|---|
model | string | AI model used by this prompt | |
slug | string | URL-safe identifier for the prompt |
Braintrust Role
braintrust_role inherits from AccessRole
| Property | Type | Description | Specifications |
|---|---|---|---|
global | boolean | Whether this is a global role (not org-specific) | |
permissionCount | number | Number of permissions granted by this role |
Braintrust Service Token
braintrust_service_token inherits from AccessKey
| Property | Type | Description | Specifications |
|---|---|---|---|
previewName | string | Preview hint of the token value | |
serviceAccountEmail | string | Email identifier of the service account | |
serviceAccountId | string | ID of the service account this token belongs to | |
serviceAccountName | string | Name of the service account |
Braintrust User
braintrust_user inherits from User
Release Notes
- 2026-04-10 — Added initial Braintrust integration, ingesting users, user groups, and access roles with their assignments.