Braintrust

Authorization
Data Model
Types
Release Notes

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)

https://www.braintrust.dev/docs/reference/api

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
`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
`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
`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

Roles​

Documentation Links​

Per-Step Breakdown​

Entities​

Relationships​

Braintrust Account​

Braintrust Ai Secret​

Braintrust Api Key​

Braintrust Dataset​

Braintrust Env Var​

Braintrust Group​

Braintrust Model​

Braintrust Project​

Braintrust Prompt​

Braintrust Role​

Braintrust Service Token​

Braintrust User​

Release Notes​