> This page is for Gateway. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.merge.dev/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server. # Create or update suite PUT https://api-gateway.merge.dev/v1/evals/suites Content-Type: application/json Create-or-update a suite by name (idempotent, for CI pipelines). 201 when the suite was created, 200 when an existing live suite with that name was updated. Only the fields present in the payload change. Reference: https://docs.merge.dev/merge-gateway/evals-api/suites/create-or-update-suite ## Authentication - `Authorization` header (bearer token, required) — Your gateway API key (mg_ prefix), the same key used for /v1/responses ## Request ### Body (application/json) This endpoint expects a SuiteUpsertV1In. - `name` (string, required) - `description` (string, optional, nullable) - `pass_criteria` (SuiteUpsertV1InPassCriteria, optional, nullable) - `judge_model` (string, optional, nullable) - `judge_rubric` (string, optional, nullable) - `judge_threshold` (double, optional, nullable) - `judge_temperature` (double, optional, nullable) ## Response ### 200 Successful Response - `id` (string, required) - `name` (string, required) - `pass_criteria` (map from string to any, required) - `judge_threshold` (double, required) - `judge_temperature` (double, required) - `created_at` (datetime, required) - `updated_at` (datetime, required) - `description` (string, optional, nullable) - `judge_model` (string, optional, nullable) - `judge_rubric` (string, optional, nullable) - `created_by` (string, optional, nullable) - `archived_at` (datetime, optional, nullable) - `case_count` (integer, optional, default: 0) - `latest_run` (SuiteLatestRunOut, optional, nullable) — Compact newest-run summary for the suites list (health at a glance). ## Errors ### 422 Unprocessable Entity Error Validation Error - `detail` (list of ValidationError, optional) ## Types ### SuiteUpsertV1InPassCriteria - `mode`: `all_required` (AllRequiredPassCriteria) - `mode`: `min_pass_rate` (MinPassRatePassCriteria) - `min_pass_rate` (double, required) ### SuiteLatestRunOut Compact newest-run summary for the suites list (health at a glance). - `id` (string, required) - `status` (string, required) - `target_model` (string, required) - `pass_count` (integer, required) - `fail_count` (integer, required) - `error_count` (integer, required) - `created_at` (datetime, required) - `passed` (boolean, optional, nullable) - `completed_at` (datetime, optional, nullable) ### ValidationError - `loc` (list of ValidationErrorLocItems, required) - `msg` (string, required) - `type` (string, required) - `input` (any, optional) - `ctx` (ValidationErrorCtx, optional) ### ValidationErrorLocItems - string - integer ### ValidationErrorCtx ## Examples **Request** ```json { "name": "string" } ``` **Response** ```json { "id": "string", "name": "string", "pass_criteria": {}, "judge_threshold": 1.1, "judge_temperature": 1.1, "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "description": "string", "judge_model": "string", "judge_rubric": "string", "created_by": "string", "archived_at": "2024-01-15T09:30:00Z", "case_count": 0, "latest_run": { "id": "string", "status": "string", "target_model": "string", "pass_count": 1, "fail_count": 1, "error_count": 1, "created_at": "2024-01-15T09:30:00Z", "passed": true, "completed_at": "2024-01-15T09:30:00Z" } } ``` **SDK Code** ```python import requests url = "https://api-gateway.merge.dev/v1/evals/suites" payload = { "name": "string" } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.put(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://api-gateway.merge.dev/v1/evals/suites'; const options = { method: 'PUT', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"string"}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api-gateway.merge.dev/v1/evals/suites" payload := strings.NewReader("{\n \"name\": \"string\"\n}") req, _ := http.NewRequest("PUT", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://api-gateway.merge.dev/v1/evals/suites") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Put.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"string\"\n}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.put("https://api-gateway.merge.dev/v1/evals/suites") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"string\"\n}") .asString(); ``` ```php request('PUT', 'https://api-gateway.merge.dev/v1/evals/suites', [ 'body' => '{ "name": "string" }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api-gateway.merge.dev/v1/evals/suites"); var request = new RestRequest(Method.PUT); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"string\"\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = ["name": "string"] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api-gateway.merge.dev/v1/evals/suites")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "PUT" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```