Env Vars - Docs - Env Vars

GET

/v1/env_var

List env_vars

List out all env_vars. The env_vars are sorted by creation date, with the most recently-created env_vars coming first

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.

In: header

Query Parameters

`limit`integer | null

Limit the number of objects to return

Minimum: 0

`ids`Any properties in string, array<string>

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

`env_var_name`string

Name of the env_var to search for

`object_type`string

The type of the object the environment variable is scoped for

Value in: "organization" | "project" | "function"

`object_id`string

The id of the object the environment variable is scoped for

Format: "uuid"

Status code	Description
`200`	Returns a list of env_var objects
`400`	The request was unacceptable, often due to missing a required parameter
`401`	No valid API key provided
`403`	The API key doesn’t have permissions to perform the request
`429`	Too many requests hit the API too quickly. We recommend an exponential backoff of your requests
`500`	Something went wrong on Braintrust's end. (These are rare.)

curl -X GET "https://api.braintrust.dev/v1/env_var?limit=0&ids=497f6eca-6276-4993-bfeb-53cbbbba6f08&env_var_name=string&object_type=organization&object_id=497f6eca-6276-4993-bfeb-53cbbbba6f08"

{
  "objects": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "object_type": "organization",
      "object_id": "463a83d0-a816-4902-abba-2486e0c0a0bb",
      "name": "string",
      "created": "2019-08-24T14:15:22Z",
      "used": "2019-08-24T14:15:22Z"
    }
  ]
}

POST

/v1/env_var

Create env_var

Create a new env_var. If there is an existing env_var with the same name as the one specified in the request, will return the existing env_var unmodified

Authorization

`Authorization`
Required
Bearer <token>

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.

In: header

Request Body (Optional)

Any desired information about the new env_var object

`object_type`
Required
string

The type of the object the environment variable is scoped for

Value in: "organization" | "project" | "function"

`object_id`
Required
string

The id of the object the environment variable is scoped for

Format: "uuid"

`name`
Required
string

The name of the environment variable

`value`string | null

The value of the environment variable. Will be encrypted at rest.

Status code	Description
`200`	Returns the new env_var object
`400`	The request was unacceptable, often due to missing a required parameter
`401`	No valid API key provided
`403`	The API key doesn’t have permissions to perform the request
`429`	Too many requests hit the API too quickly. We recommend an exponential backoff of your requests
`500`	Something went wrong on Braintrust's end. (These are rare.)

curl -X POST "https://api.braintrust.dev/v1/env_var" \
  -d '{
  "object_type": "organization",
  "object_id": "463a83d0-a816-4902-abba-2486e0c0a0bb",
  "name": "string",
  "value": "string"
}'

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "object_type": "organization",
  "object_id": "463a83d0-a816-4902-abba-2486e0c0a0bb",
  "name": "string",
  "created": "2019-08-24T14:15:22Z",
  "used": "2019-08-24T14:15:22Z"
}

PUT

/v1/env_var

Create or replace env_var

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

Authorization

`Authorization`
Required
Bearer <token>

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.

In: header

Request Body (Optional)

Any desired information about the new env_var object

`object_type`
Required
string

The type of the object the environment variable is scoped for

Value in: "organization" | "project" | "function"

`object_id`
Required
string

The id of the object the environment variable is scoped for

Format: "uuid"

`name`
Required
string

The name of the environment variable

`value`string | null

The value of the environment variable. Will be encrypted at rest.

Status code	Description
`200`	Returns the new env_var object
`400`	The request was unacceptable, often due to missing a required parameter
`401`	No valid API key provided
`403`	The API key doesn’t have permissions to perform the request
`429`	Too many requests hit the API too quickly. We recommend an exponential backoff of your requests
`500`	Something went wrong on Braintrust's end. (These are rare.)

curl -X PUT "https://api.braintrust.dev/v1/env_var" \
  -d '{
  "object_type": "organization",
  "object_id": "463a83d0-a816-4902-abba-2486e0c0a0bb",
  "name": "string",
  "value": "string"
}'

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "object_type": "organization",
  "object_id": "463a83d0-a816-4902-abba-2486e0c0a0bb",
  "name": "string",
  "created": "2019-08-24T14:15:22Z",
  "used": "2019-08-24T14:15:22Z"
}

GET

/v1/env_var/{env_var_id}

Get env_var

Get an env_var object by its id

Authorization

`Authorization`
Required
Bearer <token>

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.

In: header

Path Parameters

`env_var_id`
Required
string

EnvVar id

Format: "uuid"

Status code	Description
`200`	Returns the env_var object
`400`	The request was unacceptable, often due to missing a required parameter
`401`	No valid API key provided
`403`	The API key doesn’t have permissions to perform the request
`429`	Too many requests hit the API too quickly. We recommend an exponential backoff of your requests
`500`	Something went wrong on Braintrust's end. (These are rare.)

curl -X GET "https://api.braintrust.dev/v1/env_var/497f6eca-6276-4993-bfeb-53cbbbba6f08"

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "object_type": "organization",
  "object_id": "463a83d0-a816-4902-abba-2486e0c0a0bb",
  "name": "string",
  "created": "2019-08-24T14:15:22Z",
  "used": "2019-08-24T14:15:22Z"
}

PATCH

/v1/env_var/{env_var_id}

Partially update env_var

Partially update an env_var object. Specify the fields to update in the payload. Any object-type fields will be deep-merged with existing content. Currently we do not support removing fields or setting them to null.

Authorization

`Authorization`
Required
Bearer <token>

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.

In: header

Request Body (Optional)

Fields to update

`name`
Required
string

The name of the environment variable

`value`string | null

The value of the environment variable. Will be encrypted at rest.

Path Parameters

`env_var_id`
Required
string

EnvVar id

Format: "uuid"

Status code	Description
`200`	Returns the env_var object
`400`	The request was unacceptable, often due to missing a required parameter
`401`	No valid API key provided
`403`	The API key doesn’t have permissions to perform the request
`429`	Too many requests hit the API too quickly. We recommend an exponential backoff of your requests
`500`	Something went wrong on Braintrust's end. (These are rare.)

curl -X PATCH "https://api.braintrust.dev/v1/env_var/497f6eca-6276-4993-bfeb-53cbbbba6f08" \
  -d '{
  "name": "string",
  "value": "string"
}'

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "object_type": "organization",
  "object_id": "463a83d0-a816-4902-abba-2486e0c0a0bb",
  "name": "string",
  "created": "2019-08-24T14:15:22Z",
  "used": "2019-08-24T14:15:22Z"
}

DELETE

/v1/env_var/{env_var_id}

Delete env_var

Delete an env_var object by its id

Authorization

`Authorization`
Required
Bearer <token>

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.

In: header

Path Parameters

`env_var_id`
Required
string

EnvVar id

Format: "uuid"

Status code	Description
`200`	Returns the deleted env_var object
`400`	The request was unacceptable, often due to missing a required parameter
`401`	No valid API key provided
`403`	The API key doesn’t have permissions to perform the request
`429`	Too many requests hit the API too quickly. We recommend an exponential backoff of your requests
`500`	Something went wrong on Braintrust's end. (These are rare.)

curl -X DELETE "https://api.braintrust.dev/v1/env_var/497f6eca-6276-4993-bfeb-53cbbbba6f08"

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "object_type": "organization",
  "object_id": "463a83d0-a816-4902-abba-2486e0c0a0bb",
  "name": "string",
  "created": "2019-08-24T14:15:22Z",
  "used": "2019-08-24T14:15:22Z"
}

Query

AuthorizationRequiredBearer <token>

limitinteger | null

idsAny properties in string, array<string>

Object 1

env_var_namestring

object_typestring

object_idstring

Response

Typescript

Body

AuthorizationRequiredBearer <token>

object_typeRequiredstring

object_idRequiredstring

nameRequiredstring

valuestring | null

Response

Typescript

Body

AuthorizationRequiredBearer <token>

object_typeRequiredstring

object_idRequiredstring

nameRequiredstring

valuestring | null

Response

Typescript

Path

AuthorizationRequiredBearer <token>

env_var_idRequiredstring

Response

Typescript

Path

Body

AuthorizationRequiredBearer <token>

nameRequiredstring

valuestring | null

env_var_idRequiredstring

Response

Typescript

Path

AuthorizationRequiredBearer <token>

env_var_idRequiredstring

Response

Typescript

On this page

Query

Body

Body

Path

Path

Body

Path

`Authorization`
Required
Bearer <token>

`limit`integer | null

`ids`Any properties in string, array<string>

`env_var_name`string

`object_type`string

`object_id`string

`Authorization`
Required
Bearer <token>

`object_type`
Required
string

`object_id`
Required
string

`name`
Required
string

`value`string | null

`Authorization`
Required
Bearer <token>

`object_type`
Required
string

`object_id`
Required
string

`name`
Required
string

`value`string | null

`Authorization`
Required
Bearer <token>

`env_var_id`
Required
string

`Authorization`
Required
Bearer <token>

`name`
Required
string

`value`string | null

`env_var_id`
Required
string

`Authorization`
Required
Bearer <token>

`env_var_id`
Required
string