PUT
/
v2
/
projects
/
{project_id}
/
experiments
/
{experiment_id}
Update Experiment
curl --request PUT \
  --url https://api.galileo.ai/v2/projects/{project_id}/experiments/{experiment_id} \
  --header 'Content-Type: application/json' \
  --header 'Galileo-API-Key: <api-key>' \
  --data '{
  "name": "my_first_experiment"
}'
{
  "id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "name": "",
  "project_id": "<string>",
  "created_by": "<string>",
  "task_type": 0,
  "dataset": {
    "dataset_id": "<string>",
    "version_index": 123,
    "name": "<string>"
  },
  "aggregate_metrics": {},
  "aggregate_feedback": {},
  "ranking_score": 123,
  "rank": 123,
  "winner": true,
  "playground_id": "<string>",
  "playground": {
    "playground_id": "<string>",
    "name": "<string>"
  },
  "prompt_run_settings": {
    "logprobs": true,
    "top_logprobs": 5,
    "echo": false,
    "n": 1,
    "reasoning_effort": "medium",
    "verbosity": "medium",
    "deployment_name": "<string>",
    "model_alias": "GPT-4o",
    "temperature": 1,
    "max_tokens": 1024,
    "stop_sequences": [
      "<string>"
    ],
    "top_p": 1,
    "top_k": 40,
    "frequency_penalty": 0,
    "presence_penalty": 0,
    "tools": "<string>",
    "tool_choice": "<string>",
    "response_format": {}
  },
  "prompt_model": "<string>",
  "prompt": {
    "prompt_template_id": "<string>",
    "version_index": 123,
    "name": "<string>",
    "content": "<string>"
  },
  "tags": {}
}

Authorizations

Galileo-API-Key
string
header
required

Path Parameters

experiment_id
string<uuid4>
required
project_id
string<uuid4>
required

Body

application/json
name
string
required
Minimum length: 1
task_type
default:16

Response

Successful Response

id
string<uuid4>
required

Galileo ID of the experiment

project_id
string<uuid4>
required

Galileo ID of the project associated with this experiment

task_type
enum<integer>
required

Valid task types for modeling.

We store these as ints instead of strings because we will be looking this up in the database frequently.

Available options:
0,
1,
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18
created_at
string<date-time>

Timestamp of the experiment's creation

updated_at
string<date-time> | null

Timestamp of the trace or span's last update

name
string
default:""

Name of the experiment

created_by
string<uuid4> | null
dataset
object | null
aggregate_metrics
object
aggregate_feedback
object

Aggregate feedback information related to the experiment

ranking_score
number | null
rank
integer | null
winner
boolean | null
playground_id
string<uuid4> | null
playground
object | null
prompt_run_settings
object | null

Prompt run settings.

prompt_model
string | null
prompt
object | null
tags
object