Create or replace function
curl --request PUT \
--url https://api.braintrust.dev/v1/function \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"slug": "<string>",
"function_data": {
"type": "prompt"
},
"description": "<string>",
"prompt_data": {
"prompt": {
"type": "chat",
"messages": [
{
"role": "system",
"content": "",
"name": "<string>"
}
],
"tools": "<string>"
},
"options": {
"model": "<string>",
"params": {
"use_cache": true,
"reasoning_enabled": true,
"reasoning_budget": 123,
"temperature": 123,
"top_p": 123,
"max_tokens": 123,
"max_completion_tokens": 123,
"frequency_penalty": 123,
"presence_penalty": 123,
"response_format": {
"type": "json_object"
},
"tool_choice": "auto",
"function_call": "auto",
"n": 123,
"stop": [
"<string>"
],
"chat_template_kwargs": {
"enable_thinking": true
}
},
"position": "<string>",
"endpoint_name": "<string>"
},
"parser": {
"type": "llm_classifier",
"use_cot": true,
"choice_scores": {},
"choice": [
"<string>"
],
"allow_no_match": true,
"allow_skip": true
},
"preprocessor": {
"type": "function",
"id": "<string>",
"version": "<string>"
},
"tool_functions": [
{
"type": "function",
"id": "<string>",
"version": "<string>"
}
],
"mcp": {},
"origin": {
"prompt_id": "<string>",
"project_id": "<string>",
"prompt_version": "<string>"
}
},
"tags": [
"<string>"
],
"origin": {
"object_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"internal": true
},
"function_schema": {
"parameters": "<unknown>",
"returns": "<unknown>"
}
}
'import requests
url = "https://api.braintrust.dev/v1/function"
payload = {
"project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"slug": "<string>",
"function_data": { "type": "prompt" },
"description": "<string>",
"prompt_data": {
"prompt": {
"type": "chat",
"messages": [
{
"role": "system",
"content": "",
"name": "<string>"
}
],
"tools": "<string>"
},
"options": {
"model": "<string>",
"params": {
"use_cache": True,
"reasoning_enabled": True,
"reasoning_budget": 123,
"temperature": 123,
"top_p": 123,
"max_tokens": 123,
"max_completion_tokens": 123,
"frequency_penalty": 123,
"presence_penalty": 123,
"response_format": { "type": "json_object" },
"tool_choice": "auto",
"function_call": "auto",
"n": 123,
"stop": ["<string>"],
"chat_template_kwargs": { "enable_thinking": True }
},
"position": "<string>",
"endpoint_name": "<string>"
},
"parser": {
"type": "llm_classifier",
"use_cot": True,
"choice_scores": {},
"choice": ["<string>"],
"allow_no_match": True,
"allow_skip": True
},
"preprocessor": {
"type": "function",
"id": "<string>",
"version": "<string>"
},
"tool_functions": [
{
"type": "function",
"id": "<string>",
"version": "<string>"
}
],
"mcp": {},
"origin": {
"prompt_id": "<string>",
"project_id": "<string>",
"prompt_version": "<string>"
}
},
"tags": ["<string>"],
"origin": {
"object_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"internal": True
},
"function_schema": {
"parameters": "<unknown>",
"returns": "<unknown>"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
project_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
name: '<string>',
slug: '<string>',
function_data: {type: 'prompt'},
description: '<string>',
prompt_data: {
prompt: {
type: 'chat',
messages: [{role: 'system', content: '', name: '<string>'}],
tools: '<string>'
},
options: {
model: '<string>',
params: {
use_cache: true,
reasoning_enabled: true,
reasoning_budget: 123,
temperature: 123,
top_p: 123,
max_tokens: 123,
max_completion_tokens: 123,
frequency_penalty: 123,
presence_penalty: 123,
response_format: {type: 'json_object'},
tool_choice: 'auto',
function_call: 'auto',
n: 123,
stop: ['<string>'],
chat_template_kwargs: {enable_thinking: true}
},
position: '<string>',
endpoint_name: '<string>'
},
parser: {
type: 'llm_classifier',
use_cot: true,
choice_scores: {},
choice: ['<string>'],
allow_no_match: true,
allow_skip: true
},
preprocessor: {type: 'function', id: '<string>', version: '<string>'},
tool_functions: [{type: 'function', id: '<string>', version: '<string>'}],
mcp: {},
origin: {prompt_id: '<string>', project_id: '<string>', prompt_version: '<string>'}
},
tags: ['<string>'],
origin: {object_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a', internal: true},
function_schema: {parameters: '<unknown>', returns: '<unknown>'}
})
};
fetch('https://api.braintrust.dev/v1/function', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.braintrust.dev/v1/function",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'project_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'name' => '<string>',
'slug' => '<string>',
'function_data' => [
'type' => 'prompt'
],
'description' => '<string>',
'prompt_data' => [
'prompt' => [
'type' => 'chat',
'messages' => [
[
'role' => 'system',
'content' => '',
'name' => '<string>'
]
],
'tools' => '<string>'
],
'options' => [
'model' => '<string>',
'params' => [
'use_cache' => true,
'reasoning_enabled' => true,
'reasoning_budget' => 123,
'temperature' => 123,
'top_p' => 123,
'max_tokens' => 123,
'max_completion_tokens' => 123,
'frequency_penalty' => 123,
'presence_penalty' => 123,
'response_format' => [
'type' => 'json_object'
],
'tool_choice' => 'auto',
'function_call' => 'auto',
'n' => 123,
'stop' => [
'<string>'
],
'chat_template_kwargs' => [
'enable_thinking' => true
]
],
'position' => '<string>',
'endpoint_name' => '<string>'
],
'parser' => [
'type' => 'llm_classifier',
'use_cot' => true,
'choice_scores' => [
],
'choice' => [
'<string>'
],
'allow_no_match' => true,
'allow_skip' => true
],
'preprocessor' => [
'type' => 'function',
'id' => '<string>',
'version' => '<string>'
],
'tool_functions' => [
[
'type' => 'function',
'id' => '<string>',
'version' => '<string>'
]
],
'mcp' => [
],
'origin' => [
'prompt_id' => '<string>',
'project_id' => '<string>',
'prompt_version' => '<string>'
]
],
'tags' => [
'<string>'
],
'origin' => [
'object_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'internal' => true
],
'function_schema' => [
'parameters' => '<unknown>',
'returns' => '<unknown>'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.braintrust.dev/v1/function"
payload := strings.NewReader("{\n \"project_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"name\": \"<string>\",\n \"slug\": \"<string>\",\n \"function_data\": {\n \"type\": \"prompt\"\n },\n \"description\": \"<string>\",\n \"prompt_data\": {\n \"prompt\": {\n \"type\": \"chat\",\n \"messages\": [\n {\n \"role\": \"system\",\n \"content\": \"\",\n \"name\": \"<string>\"\n }\n ],\n \"tools\": \"<string>\"\n },\n \"options\": {\n \"model\": \"<string>\",\n \"params\": {\n \"use_cache\": true,\n \"reasoning_enabled\": true,\n \"reasoning_budget\": 123,\n \"temperature\": 123,\n \"top_p\": 123,\n \"max_tokens\": 123,\n \"max_completion_tokens\": 123,\n \"frequency_penalty\": 123,\n \"presence_penalty\": 123,\n \"response_format\": {\n \"type\": \"json_object\"\n },\n \"tool_choice\": \"auto\",\n \"function_call\": \"auto\",\n \"n\": 123,\n \"stop\": [\n \"<string>\"\n ],\n \"chat_template_kwargs\": {\n \"enable_thinking\": true\n }\n },\n \"position\": \"<string>\",\n \"endpoint_name\": \"<string>\"\n },\n \"parser\": {\n \"type\": \"llm_classifier\",\n \"use_cot\": true,\n \"choice_scores\": {},\n \"choice\": [\n \"<string>\"\n ],\n \"allow_no_match\": true,\n \"allow_skip\": true\n },\n \"preprocessor\": {\n \"type\": \"function\",\n \"id\": \"<string>\",\n \"version\": \"<string>\"\n },\n \"tool_functions\": [\n {\n \"type\": \"function\",\n \"id\": \"<string>\",\n \"version\": \"<string>\"\n }\n ],\n \"mcp\": {},\n \"origin\": {\n \"prompt_id\": \"<string>\",\n \"project_id\": \"<string>\",\n \"prompt_version\": \"<string>\"\n }\n },\n \"tags\": [\n \"<string>\"\n ],\n \"origin\": {\n \"object_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"internal\": true\n },\n \"function_schema\": {\n \"parameters\": \"<unknown>\",\n \"returns\": \"<unknown>\"\n }\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.braintrust.dev/v1/function")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"project_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"name\": \"<string>\",\n \"slug\": \"<string>\",\n \"function_data\": {\n \"type\": \"prompt\"\n },\n \"description\": \"<string>\",\n \"prompt_data\": {\n \"prompt\": {\n \"type\": \"chat\",\n \"messages\": [\n {\n \"role\": \"system\",\n \"content\": \"\",\n \"name\": \"<string>\"\n }\n ],\n \"tools\": \"<string>\"\n },\n \"options\": {\n \"model\": \"<string>\",\n \"params\": {\n \"use_cache\": true,\n \"reasoning_enabled\": true,\n \"reasoning_budget\": 123,\n \"temperature\": 123,\n \"top_p\": 123,\n \"max_tokens\": 123,\n \"max_completion_tokens\": 123,\n \"frequency_penalty\": 123,\n \"presence_penalty\": 123,\n \"response_format\": {\n \"type\": \"json_object\"\n },\n \"tool_choice\": \"auto\",\n \"function_call\": \"auto\",\n \"n\": 123,\n \"stop\": [\n \"<string>\"\n ],\n \"chat_template_kwargs\": {\n \"enable_thinking\": true\n }\n },\n \"position\": \"<string>\",\n \"endpoint_name\": \"<string>\"\n },\n \"parser\": {\n \"type\": \"llm_classifier\",\n \"use_cot\": true,\n \"choice_scores\": {},\n \"choice\": [\n \"<string>\"\n ],\n \"allow_no_match\": true,\n \"allow_skip\": true\n },\n \"preprocessor\": {\n \"type\": \"function\",\n \"id\": \"<string>\",\n \"version\": \"<string>\"\n },\n \"tool_functions\": [\n {\n \"type\": \"function\",\n \"id\": \"<string>\",\n \"version\": \"<string>\"\n }\n ],\n \"mcp\": {},\n \"origin\": {\n \"prompt_id\": \"<string>\",\n \"project_id\": \"<string>\",\n \"prompt_version\": \"<string>\"\n }\n },\n \"tags\": [\n \"<string>\"\n ],\n \"origin\": {\n \"object_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"internal\": true\n },\n \"function_schema\": {\n \"parameters\": \"<unknown>\",\n \"returns\": \"<unknown>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.braintrust.dev/v1/function")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"project_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"name\": \"<string>\",\n \"slug\": \"<string>\",\n \"function_data\": {\n \"type\": \"prompt\"\n },\n \"description\": \"<string>\",\n \"prompt_data\": {\n \"prompt\": {\n \"type\": \"chat\",\n \"messages\": [\n {\n \"role\": \"system\",\n \"content\": \"\",\n \"name\": \"<string>\"\n }\n ],\n \"tools\": \"<string>\"\n },\n \"options\": {\n \"model\": \"<string>\",\n \"params\": {\n \"use_cache\": true,\n \"reasoning_enabled\": true,\n \"reasoning_budget\": 123,\n \"temperature\": 123,\n \"top_p\": 123,\n \"max_tokens\": 123,\n \"max_completion_tokens\": 123,\n \"frequency_penalty\": 123,\n \"presence_penalty\": 123,\n \"response_format\": {\n \"type\": \"json_object\"\n },\n \"tool_choice\": \"auto\",\n \"function_call\": \"auto\",\n \"n\": 123,\n \"stop\": [\n \"<string>\"\n ],\n \"chat_template_kwargs\": {\n \"enable_thinking\": true\n }\n },\n \"position\": \"<string>\",\n \"endpoint_name\": \"<string>\"\n },\n \"parser\": {\n \"type\": \"llm_classifier\",\n \"use_cot\": true,\n \"choice_scores\": {},\n \"choice\": [\n \"<string>\"\n ],\n \"allow_no_match\": true,\n \"allow_skip\": true\n },\n \"preprocessor\": {\n \"type\": \"function\",\n \"id\": \"<string>\",\n \"version\": \"<string>\"\n },\n \"tool_functions\": [\n {\n \"type\": \"function\",\n \"id\": \"<string>\",\n \"version\": \"<string>\"\n }\n ],\n \"mcp\": {},\n \"origin\": {\n \"prompt_id\": \"<string>\",\n \"project_id\": \"<string>\",\n \"prompt_version\": \"<string>\"\n }\n },\n \"tags\": [\n \"<string>\"\n ],\n \"origin\": {\n \"object_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"internal\": true\n },\n \"function_schema\": {\n \"parameters\": \"<unknown>\",\n \"returns\": \"<unknown>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"_xact_id": "<string>",
"project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"log_id": "p",
"org_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"slug": "<string>",
"function_data": {
"type": "prompt"
},
"description": "<string>",
"created": "2023-11-07T05:31:56Z",
"prompt_data": {
"prompt": {
"type": "chat",
"messages": [
{
"role": "system",
"content": "",
"name": "<string>"
}
],
"tools": "<string>"
},
"options": {
"model": "<string>",
"params": {
"use_cache": true,
"reasoning_enabled": true,
"reasoning_budget": 123,
"temperature": 123,
"top_p": 123,
"max_tokens": 123,
"max_completion_tokens": 123,
"frequency_penalty": 123,
"presence_penalty": 123,
"response_format": {
"type": "json_object"
},
"tool_choice": "auto",
"function_call": "auto",
"n": 123,
"stop": [
"<string>"
],
"reasoning_effort": "none",
"chat_template_kwargs": {
"enable_thinking": true
},
"verbosity": "low"
},
"position": "<string>",
"endpoint_name": "<string>"
},
"parser": {
"type": "llm_classifier",
"use_cot": true,
"choice_scores": {},
"choice": [
"<string>"
],
"allow_no_match": true,
"allow_skip": true
},
"preprocessor": {
"type": "function",
"id": "<string>",
"version": "<string>"
},
"tool_functions": [
{
"type": "function",
"id": "<string>",
"version": "<string>"
}
],
"template_format": "mustache",
"mcp": {},
"origin": {
"prompt_id": "<string>",
"project_id": "<string>",
"prompt_version": "<string>"
}
},
"tags": [
"<string>"
],
"metadata": {},
"function_type": "llm",
"origin": {
"object_type": "organization",
"object_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"internal": true
},
"function_schema": {
"parameters": "<unknown>",
"returns": "<unknown>"
}
}<string><string><string><string><string>Functions
Create or replace function
Create or replace function. If there is an existing function in the project with the same slug as the one specified in the request, a new version of the function will be appended and returned
PUT
/
v1
/
function
Create or replace function
curl --request PUT \
--url https://api.braintrust.dev/v1/function \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"slug": "<string>",
"function_data": {
"type": "prompt"
},
"description": "<string>",
"prompt_data": {
"prompt": {
"type": "chat",
"messages": [
{
"role": "system",
"content": "",
"name": "<string>"
}
],
"tools": "<string>"
},
"options": {
"model": "<string>",
"params": {
"use_cache": true,
"reasoning_enabled": true,
"reasoning_budget": 123,
"temperature": 123,
"top_p": 123,
"max_tokens": 123,
"max_completion_tokens": 123,
"frequency_penalty": 123,
"presence_penalty": 123,
"response_format": {
"type": "json_object"
},
"tool_choice": "auto",
"function_call": "auto",
"n": 123,
"stop": [
"<string>"
],
"chat_template_kwargs": {
"enable_thinking": true
}
},
"position": "<string>",
"endpoint_name": "<string>"
},
"parser": {
"type": "llm_classifier",
"use_cot": true,
"choice_scores": {},
"choice": [
"<string>"
],
"allow_no_match": true,
"allow_skip": true
},
"preprocessor": {
"type": "function",
"id": "<string>",
"version": "<string>"
},
"tool_functions": [
{
"type": "function",
"id": "<string>",
"version": "<string>"
}
],
"mcp": {},
"origin": {
"prompt_id": "<string>",
"project_id": "<string>",
"prompt_version": "<string>"
}
},
"tags": [
"<string>"
],
"origin": {
"object_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"internal": true
},
"function_schema": {
"parameters": "<unknown>",
"returns": "<unknown>"
}
}
'import requests
url = "https://api.braintrust.dev/v1/function"
payload = {
"project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"slug": "<string>",
"function_data": { "type": "prompt" },
"description": "<string>",
"prompt_data": {
"prompt": {
"type": "chat",
"messages": [
{
"role": "system",
"content": "",
"name": "<string>"
}
],
"tools": "<string>"
},
"options": {
"model": "<string>",
"params": {
"use_cache": True,
"reasoning_enabled": True,
"reasoning_budget": 123,
"temperature": 123,
"top_p": 123,
"max_tokens": 123,
"max_completion_tokens": 123,
"frequency_penalty": 123,
"presence_penalty": 123,
"response_format": { "type": "json_object" },
"tool_choice": "auto",
"function_call": "auto",
"n": 123,
"stop": ["<string>"],
"chat_template_kwargs": { "enable_thinking": True }
},
"position": "<string>",
"endpoint_name": "<string>"
},
"parser": {
"type": "llm_classifier",
"use_cot": True,
"choice_scores": {},
"choice": ["<string>"],
"allow_no_match": True,
"allow_skip": True
},
"preprocessor": {
"type": "function",
"id": "<string>",
"version": "<string>"
},
"tool_functions": [
{
"type": "function",
"id": "<string>",
"version": "<string>"
}
],
"mcp": {},
"origin": {
"prompt_id": "<string>",
"project_id": "<string>",
"prompt_version": "<string>"
}
},
"tags": ["<string>"],
"origin": {
"object_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"internal": True
},
"function_schema": {
"parameters": "<unknown>",
"returns": "<unknown>"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
project_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
name: '<string>',
slug: '<string>',
function_data: {type: 'prompt'},
description: '<string>',
prompt_data: {
prompt: {
type: 'chat',
messages: [{role: 'system', content: '', name: '<string>'}],
tools: '<string>'
},
options: {
model: '<string>',
params: {
use_cache: true,
reasoning_enabled: true,
reasoning_budget: 123,
temperature: 123,
top_p: 123,
max_tokens: 123,
max_completion_tokens: 123,
frequency_penalty: 123,
presence_penalty: 123,
response_format: {type: 'json_object'},
tool_choice: 'auto',
function_call: 'auto',
n: 123,
stop: ['<string>'],
chat_template_kwargs: {enable_thinking: true}
},
position: '<string>',
endpoint_name: '<string>'
},
parser: {
type: 'llm_classifier',
use_cot: true,
choice_scores: {},
choice: ['<string>'],
allow_no_match: true,
allow_skip: true
},
preprocessor: {type: 'function', id: '<string>', version: '<string>'},
tool_functions: [{type: 'function', id: '<string>', version: '<string>'}],
mcp: {},
origin: {prompt_id: '<string>', project_id: '<string>', prompt_version: '<string>'}
},
tags: ['<string>'],
origin: {object_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a', internal: true},
function_schema: {parameters: '<unknown>', returns: '<unknown>'}
})
};
fetch('https://api.braintrust.dev/v1/function', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.braintrust.dev/v1/function",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'project_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'name' => '<string>',
'slug' => '<string>',
'function_data' => [
'type' => 'prompt'
],
'description' => '<string>',
'prompt_data' => [
'prompt' => [
'type' => 'chat',
'messages' => [
[
'role' => 'system',
'content' => '',
'name' => '<string>'
]
],
'tools' => '<string>'
],
'options' => [
'model' => '<string>',
'params' => [
'use_cache' => true,
'reasoning_enabled' => true,
'reasoning_budget' => 123,
'temperature' => 123,
'top_p' => 123,
'max_tokens' => 123,
'max_completion_tokens' => 123,
'frequency_penalty' => 123,
'presence_penalty' => 123,
'response_format' => [
'type' => 'json_object'
],
'tool_choice' => 'auto',
'function_call' => 'auto',
'n' => 123,
'stop' => [
'<string>'
],
'chat_template_kwargs' => [
'enable_thinking' => true
]
],
'position' => '<string>',
'endpoint_name' => '<string>'
],
'parser' => [
'type' => 'llm_classifier',
'use_cot' => true,
'choice_scores' => [
],
'choice' => [
'<string>'
],
'allow_no_match' => true,
'allow_skip' => true
],
'preprocessor' => [
'type' => 'function',
'id' => '<string>',
'version' => '<string>'
],
'tool_functions' => [
[
'type' => 'function',
'id' => '<string>',
'version' => '<string>'
]
],
'mcp' => [
],
'origin' => [
'prompt_id' => '<string>',
'project_id' => '<string>',
'prompt_version' => '<string>'
]
],
'tags' => [
'<string>'
],
'origin' => [
'object_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'internal' => true
],
'function_schema' => [
'parameters' => '<unknown>',
'returns' => '<unknown>'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.braintrust.dev/v1/function"
payload := strings.NewReader("{\n \"project_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"name\": \"<string>\",\n \"slug\": \"<string>\",\n \"function_data\": {\n \"type\": \"prompt\"\n },\n \"description\": \"<string>\",\n \"prompt_data\": {\n \"prompt\": {\n \"type\": \"chat\",\n \"messages\": [\n {\n \"role\": \"system\",\n \"content\": \"\",\n \"name\": \"<string>\"\n }\n ],\n \"tools\": \"<string>\"\n },\n \"options\": {\n \"model\": \"<string>\",\n \"params\": {\n \"use_cache\": true,\n \"reasoning_enabled\": true,\n \"reasoning_budget\": 123,\n \"temperature\": 123,\n \"top_p\": 123,\n \"max_tokens\": 123,\n \"max_completion_tokens\": 123,\n \"frequency_penalty\": 123,\n \"presence_penalty\": 123,\n \"response_format\": {\n \"type\": \"json_object\"\n },\n \"tool_choice\": \"auto\",\n \"function_call\": \"auto\",\n \"n\": 123,\n \"stop\": [\n \"<string>\"\n ],\n \"chat_template_kwargs\": {\n \"enable_thinking\": true\n }\n },\n \"position\": \"<string>\",\n \"endpoint_name\": \"<string>\"\n },\n \"parser\": {\n \"type\": \"llm_classifier\",\n \"use_cot\": true,\n \"choice_scores\": {},\n \"choice\": [\n \"<string>\"\n ],\n \"allow_no_match\": true,\n \"allow_skip\": true\n },\n \"preprocessor\": {\n \"type\": \"function\",\n \"id\": \"<string>\",\n \"version\": \"<string>\"\n },\n \"tool_functions\": [\n {\n \"type\": \"function\",\n \"id\": \"<string>\",\n \"version\": \"<string>\"\n }\n ],\n \"mcp\": {},\n \"origin\": {\n \"prompt_id\": \"<string>\",\n \"project_id\": \"<string>\",\n \"prompt_version\": \"<string>\"\n }\n },\n \"tags\": [\n \"<string>\"\n ],\n \"origin\": {\n \"object_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"internal\": true\n },\n \"function_schema\": {\n \"parameters\": \"<unknown>\",\n \"returns\": \"<unknown>\"\n }\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.braintrust.dev/v1/function")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"project_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"name\": \"<string>\",\n \"slug\": \"<string>\",\n \"function_data\": {\n \"type\": \"prompt\"\n },\n \"description\": \"<string>\",\n \"prompt_data\": {\n \"prompt\": {\n \"type\": \"chat\",\n \"messages\": [\n {\n \"role\": \"system\",\n \"content\": \"\",\n \"name\": \"<string>\"\n }\n ],\n \"tools\": \"<string>\"\n },\n \"options\": {\n \"model\": \"<string>\",\n \"params\": {\n \"use_cache\": true,\n \"reasoning_enabled\": true,\n \"reasoning_budget\": 123,\n \"temperature\": 123,\n \"top_p\": 123,\n \"max_tokens\": 123,\n \"max_completion_tokens\": 123,\n \"frequency_penalty\": 123,\n \"presence_penalty\": 123,\n \"response_format\": {\n \"type\": \"json_object\"\n },\n \"tool_choice\": \"auto\",\n \"function_call\": \"auto\",\n \"n\": 123,\n \"stop\": [\n \"<string>\"\n ],\n \"chat_template_kwargs\": {\n \"enable_thinking\": true\n }\n },\n \"position\": \"<string>\",\n \"endpoint_name\": \"<string>\"\n },\n \"parser\": {\n \"type\": \"llm_classifier\",\n \"use_cot\": true,\n \"choice_scores\": {},\n \"choice\": [\n \"<string>\"\n ],\n \"allow_no_match\": true,\n \"allow_skip\": true\n },\n \"preprocessor\": {\n \"type\": \"function\",\n \"id\": \"<string>\",\n \"version\": \"<string>\"\n },\n \"tool_functions\": [\n {\n \"type\": \"function\",\n \"id\": \"<string>\",\n \"version\": \"<string>\"\n }\n ],\n \"mcp\": {},\n \"origin\": {\n \"prompt_id\": \"<string>\",\n \"project_id\": \"<string>\",\n \"prompt_version\": \"<string>\"\n }\n },\n \"tags\": [\n \"<string>\"\n ],\n \"origin\": {\n \"object_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"internal\": true\n },\n \"function_schema\": {\n \"parameters\": \"<unknown>\",\n \"returns\": \"<unknown>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.braintrust.dev/v1/function")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"project_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"name\": \"<string>\",\n \"slug\": \"<string>\",\n \"function_data\": {\n \"type\": \"prompt\"\n },\n \"description\": \"<string>\",\n \"prompt_data\": {\n \"prompt\": {\n \"type\": \"chat\",\n \"messages\": [\n {\n \"role\": \"system\",\n \"content\": \"\",\n \"name\": \"<string>\"\n }\n ],\n \"tools\": \"<string>\"\n },\n \"options\": {\n \"model\": \"<string>\",\n \"params\": {\n \"use_cache\": true,\n \"reasoning_enabled\": true,\n \"reasoning_budget\": 123,\n \"temperature\": 123,\n \"top_p\": 123,\n \"max_tokens\": 123,\n \"max_completion_tokens\": 123,\n \"frequency_penalty\": 123,\n \"presence_penalty\": 123,\n \"response_format\": {\n \"type\": \"json_object\"\n },\n \"tool_choice\": \"auto\",\n \"function_call\": \"auto\",\n \"n\": 123,\n \"stop\": [\n \"<string>\"\n ],\n \"chat_template_kwargs\": {\n \"enable_thinking\": true\n }\n },\n \"position\": \"<string>\",\n \"endpoint_name\": \"<string>\"\n },\n \"parser\": {\n \"type\": \"llm_classifier\",\n \"use_cot\": true,\n \"choice_scores\": {},\n \"choice\": [\n \"<string>\"\n ],\n \"allow_no_match\": true,\n \"allow_skip\": true\n },\n \"preprocessor\": {\n \"type\": \"function\",\n \"id\": \"<string>\",\n \"version\": \"<string>\"\n },\n \"tool_functions\": [\n {\n \"type\": \"function\",\n \"id\": \"<string>\",\n \"version\": \"<string>\"\n }\n ],\n \"mcp\": {},\n \"origin\": {\n \"prompt_id\": \"<string>\",\n \"project_id\": \"<string>\",\n \"prompt_version\": \"<string>\"\n }\n },\n \"tags\": [\n \"<string>\"\n ],\n \"origin\": {\n \"object_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"internal\": true\n },\n \"function_schema\": {\n \"parameters\": \"<unknown>\",\n \"returns\": \"<unknown>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"_xact_id": "<string>",
"project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"log_id": "p",
"org_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"slug": "<string>",
"function_data": {
"type": "prompt"
},
"description": "<string>",
"created": "2023-11-07T05:31:56Z",
"prompt_data": {
"prompt": {
"type": "chat",
"messages": [
{
"role": "system",
"content": "",
"name": "<string>"
}
],
"tools": "<string>"
},
"options": {
"model": "<string>",
"params": {
"use_cache": true,
"reasoning_enabled": true,
"reasoning_budget": 123,
"temperature": 123,
"top_p": 123,
"max_tokens": 123,
"max_completion_tokens": 123,
"frequency_penalty": 123,
"presence_penalty": 123,
"response_format": {
"type": "json_object"
},
"tool_choice": "auto",
"function_call": "auto",
"n": 123,
"stop": [
"<string>"
],
"reasoning_effort": "none",
"chat_template_kwargs": {
"enable_thinking": true
},
"verbosity": "low"
},
"position": "<string>",
"endpoint_name": "<string>"
},
"parser": {
"type": "llm_classifier",
"use_cot": true,
"choice_scores": {},
"choice": [
"<string>"
],
"allow_no_match": true,
"allow_skip": true
},
"preprocessor": {
"type": "function",
"id": "<string>",
"version": "<string>"
},
"tool_functions": [
{
"type": "function",
"id": "<string>",
"version": "<string>"
}
],
"template_format": "mustache",
"mcp": {},
"origin": {
"prompt_id": "<string>",
"project_id": "<string>",
"prompt_version": "<string>"
}
},
"tags": [
"<string>"
],
"metadata": {},
"function_type": "llm",
"origin": {
"object_type": "organization",
"object_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"internal": true
},
"function_schema": {
"parameters": "<unknown>",
"returns": "<unknown>"
}
}<string><string><string><string><string>Authorizations
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.
Body
application/json
Any desired information about the new function object
Unique identifier for the project that the prompt belongs under
Name of the prompt
Minimum string length:
1Unique identifier for the prompt
Minimum string length:
1- prompt
- code
- graph
- remote_eval
- global
- facet
- batched_facet
- parameters
- topic_map
- simulation
Show child attributes
Show child attributes
Textual description of the prompt
The prompt, model, and its parameters
Show child attributes
Show child attributes
A list of tags for the prompt
Available options:
llm, scorer, task, tool, custom_view, preprocessor, facet, classifier, tag, parameters, sandbox, null Show child attributes
Show child attributes
JSON schema for the function's parameters and return type
Show child attributes
Show child attributes
Response
Returns the new function object
Unique identifier for the prompt
The transaction id of an event is unique to the network operation that processed the event insertion. Transaction ids are monotonically increasing over time and can be used to retrieve a versioned snapshot of the prompt (see the version parameter)
Unique identifier for the project that the prompt belongs under
A literal 'p' which identifies the object as a project prompt
Available options:
p Unique identifier for the organization
Name of the prompt
Unique identifier for the prompt
- prompt
- code
- graph
- remote_eval
- global
- facet
- batched_facet
- parameters
- topic_map
- simulation
Show child attributes
Show child attributes
Textual description of the prompt
Date of prompt creation
The prompt, model, and its parameters
Show child attributes
Show child attributes
A list of tags for the prompt
User-controlled metadata about the prompt
Show child attributes
Show child attributes
Available options:
llm, scorer, task, tool, custom_view, preprocessor, facet, classifier, tag, parameters, sandbox, null Show child attributes
Show child attributes
JSON schema for the function's parameters and return type
Show child attributes
Show child attributes
Was this page helpful?