BRbraintrustdata
ProjectGroups

Create or replace project group

Changed on

Create or replace project group. If there is an existing project group with the same name as the one specified in the request, will replace the existing project group with the provided fields

put/v1/project_group

Request

  • Base URL
    https://api.braintrust.dev
  • Auth
    • HTTP bearer
    • or none

Request body

namestring required

Name of the project group

descriptionstring nullable

Textual description of the project group

org_namestring nullable

For nearly all users, this parameter should be unnecessary. But in the rare case that your API key belongs to multiple organizations, you may specify the name of the organization the project group belongs in.

Response

Returns the new project group object

idstring uuid required

Unique identifier for the project group

org_idstring uuid required

Unique id for the organization that the project group belongs under

It is forbidden to change the org after creating a project group

user_idstring uuid nullable

Identifies the user who created the project group

createdstring date-time nullable

Date of project group creation

namestring required

Name of the project group

descriptionstring nullable

Textual description of the project group

deleted_atstring date-time nullable

Date of project group deletion, or null if the project group is still active

member_projectsstring[] required

Sorted ids of active projects in this project group. Modifying membership requires project_group:update on the group.

Changes