Skip to main content
GET
List projects
workspace_external_id is optional.
  • Omitted, a session caller gets projects across every workspace they belong to; an API-key caller is always confined to its own workspace regardless.
  • Supplied but not a well-formed UUID returns 400.
  • Supplied but not a workspace the caller can access returns 404.

Authorizations

Authorization
string
header
required

Most Braintrust endpoints are authenticated by providing your API key as a header Authorization: Bearer [api_key] to your HTTP request. You can create an API key in the Braintrust organization settings page.

Query Parameters

limit
integer | null

Limit the number of objects to return

Required range: x >= 0
starting_after
string<uuid>

Pagination cursor id.

For example, if the final item in the last page you fetched had an id of foo, pass starting_after=foo to fetch the next page. Note: you may only pass one of starting_after and ending_before

ending_before
string<uuid>

Pagination cursor id.

For example, if the initial item in the last page you fetched had an id of foo, pass ending_before=foo to fetch the previous page. Note: you may only pass one of starting_after and ending_before

ids

Filter search results to a particular set of object IDs. To specify a list of IDs, include the query param multiple times

project_name
string

Name of the project to search for

org_name
string

Filter search results to within a particular organization

Response

Returns a list of project objects

objects
object[]
required

A list of project objects