How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Braintrust Acls API

The Acls API from Braintrust — 4 operation(s) for acls.

Braintrust Acls API is one of 41 APIs that Braintrust publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include ACL. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 7 operations across 4 paths, and defines 20 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against a single base URL, https://api.braintrust.dev.

7 operations 4 paths 20 schemas 2 DELETE3 GET2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://api.braintrust.dev
Authentication
HTTP Bearer
License
Apache 2.0
Resource Areas
1

Authentication & Security 1

Braintrust Acls API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (API key or JWT) (bearerAuth). By default, every request must be authenticated, though some operations may also be called without credentials.

  • bearerAuth — Most Braintrust endpoints are authenticated by providing your API key as a header Authorization: Bearer [apikey] to your HTTP request. You can create an API ke…

Paths & Operations 7

Across 4 paths, the API surfaces 7 operations — 2 DELETE, 3 GET, 2 POST. Each is listed below with its method, path, parameters, and response codes.

Acls 7
POST
/v1/acl
Create acl
postAcl body → 200400401403429500
DELETE
/v1/acl
Delete single acl
deleteAcl body → 200400401403429500
GET
/v1/acl
List acls
getAcl 11 params → 200400401403429500
GET
/v1/acl/{acl_id}
Get acl
getAclId 1 param → 200400401403429500
DELETE
/v1/acl/{acl_id}
Delete acl
deleteAclId 1 param → 200400401403429500
POST
/v1/acl/batch_update
Batch update acls
aclBatchUpdate body → 200400401403429500
GET
/v1/acl/list_org
List org acls
aclListOrg 12 params → 200400401403429500

Schemas 20

The contract defines 20 schemas that model the data the API accepts and returns. The most detailed are Acl (10 properties), AclItem (7 properties), AclBatchUpdateRequest (2 properties), AclBatchUpdateResponse (2 properties). Each schema is shown below with its type and property counts.

AclListOrgObjectType
string
The object type that the ACL applies to
OrgName
string
Filter search results to within a particular organization
StartingAfter
string
Pagination cursor id. For example, if the final item in the last page you fetched had an id of foo, pass startingafter=foo to fetch the next page. Note: you ma…
Acl
object
An ACL grants a certain permission or role to a certain user or group on an object. ACLs are inherited across the object hierarchy. So for example, if a user h…
10 properties 4 required
EndingBefore
string
Pagination cursor id. For example, if the initial item in the last page you fetched had an id of foo, pass endingbefore=foo to fetch the previous page. Note: y…
AclListRoleId
string
Id of the role the ACL grants. Exactly one of permission and roleid will be provided
Ids
Filter search results to a particular set of object IDs. To specify a list of IDs, include the query param multiple times
Permission
string
Each permission permits a certain type of operation on an object in the system Permissions can be assigned to to objects on an individual basis, or grouped int…
AclObjectId
string
The id of the object the ACL applies to
AclListOrgObjectId
string
The id of the object the ACL applies to
AclBatchUpdateResponse
object
2 properties 2 required
AclBatchUpdateRequest
object
2 properties
AclItem
object
An ACL grants a certain permission or role to a certain user or group on an object. ACLs are inherited across the object hierarchy. So for example, if a user h…
7 properties 2 required
AppLimitParam
integer
Limit the number of objects to return
AclListGroupId
string
Id of the group the ACL applies to. Exactly one of userid and groupid will be provided
AclObjectType
string
The object type that the ACL applies to
AclListRestrictObjectType
string
The object type that the ACL applies to
AclListUserId
string
Id of the user the ACL applies to. Exactly one of userid and groupid will be provided
AclListPermission
string
Each permission permits a certain type of operation on an object in the system Permissions can be assigned to to objects on an individual basis, or grouped int…
AclIdParam
string
Acl id

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

braintrust-acls-api-openapi.yml Raw ↑

Other APIs Braintrust publishes across the network.

Braintrust API
Braintrust AiSecrets API
Braintrust ApiKeys API
Braintrust CORS API
Braintrust CrossObject API
Braintrust Datasets API
Braintrust DatasetSnapshots API
Braintrust Environments API
Braintrust EnvVars API
Braintrust Evals API
Braintrust Experiments API
Braintrust Functions API
Where this information came from

This is an independent, third-party profile of Braintrust Acls API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.