Promote a value candidate

curl --request POST \
  --url https://rei-neuroadapt-api.reilabs.org/api/v1/domains/{domain_id}/value/promote

const options = {method: 'POST'};

fetch('https://rei-neuroadapt-api.reilabs.org/api/v1/domains/{domain_id}/value/promote', 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://rei-neuroadapt-api.reilabs.org/api/v1/domains/{domain_id}/value/promote",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://rei-neuroadapt-api.reilabs.org/api/v1/domains/{domain_id}/value/promote"

	req, _ := http.NewRequest("POST", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://rei-neuroadapt-api.reilabs.org/api/v1/domains/{domain_id}/value/promote")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body

Promote the candidate identified by expected_model_sha256. Include the expected incumbent identity when adopting after a paired comparison. Value promotion explains the observed confidence gate, HTTP 409 rejection, and the difference between fitting, checkpoint selection, and installation. The tables below reproduce request fields from archived schema-version-5 build 0136121bd2cf9d4cdbcb114565c7e1ffb74c5a63. A default marked “Not declared” is absent from that schema; it does not mean null. See source and response notes for the evidence scope.

Path, headers, and query

Send the hosted API key as Authorization: Bearer <ADAPT1_API_KEY>. The authenticated identity determines ownership; follow HTTP and contracts for the session placeholder.

Parameter	Location	Required	Type	Constraints
`domain_id`	path	Yes	`string`	No further constraint declared
`X-Neuroadapt-Session-Id`	header	No	`string` or `null`	No further constraint declared

X-Neuroadapt-Session-Id is a compatibility header present in the archived backend schema. It does not replace the hosted bearer identity.

JSON body contract

Content type: application/json. The HTTP request body is required. The following table describes its fields; linked schema names lead to the complete nested definitions on this page. When an array type also permits null, that alternative applies to the entire field, not to individual array items.

Request body

Schema: ValuePromoteRequest. Fields outside this object’s declared properties are rejected by the schema.

Field	Required	Type	Declared default	Constraints
`canary`	No	ValueCanary or `null`	Not declared	No further constraint declared
`expected_current_model_sha256`	No	`string` or `null`	Not declared	64 characters exactly
`expected_model_sha256`	Yes	`string`	Not declared	64 characters exactly
`session_id`	Yes	`string`	Not declared	At least 1 character

ValueCanary

Schema: ValueCanary. Fields outside this object’s declared properties are rejected by the schema.

Field	Required	Type	Declared default	Constraints
`cases`	Yes	array of CanaryCase	Not declared	2 to 10000 items
`minimum_cases`	No	`integer`	`16`	Minimum `2`; Maximum `10000`
`required_improvement`	No	`number`	`0`	Minimum `0`; Maximum `1`

CanaryCase

Schema: CanaryCase. Fields outside this object’s declared properties are rejected by the schema.

Field	Required	Type	Declared default	Constraints
`candidate_utility`	Yes	`number`	Not declared	Minimum `0`; Maximum `1`
`case_id`	Yes	`string`	Not declared	1 to 256 characters
`incumbent_utility`	Yes	`number`	Not declared	Minimum `0`; Maximum `1`

Responses

HTTP status	Archived contract
200	Successful JSON response. The archived schema does not type its properties.
422	Request validation error; the archived schema references `HTTPValidationError`.

The archived validation shape has an optional detail array. Each validation entry requires loc (an array of strings or integers), msg (string), and type (string); it can also include ctx (object) and input (any JSON value). Recorded operational refusals can have their own error details. Observed promotion can return HTTP 409 when the application canary does not demonstrate sufficient improvement. Preserve its reason and check the installed identity; see promotion decisions.

Promote a value candidate

curl --request POST \
  --url https://rei-neuroadapt-api.reilabs.org/api/v1/domains/{domain_id}/value/promote

const options = {method: 'POST'};

fetch('https://rei-neuroadapt-api.reilabs.org/api/v1/domains/{domain_id}/value/promote', 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://rei-neuroadapt-api.reilabs.org/api/v1/domains/{domain_id}/value/promote",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://rei-neuroadapt-api.reilabs.org/api/v1/domains/{domain_id}/value/promote"

	req, _ := http.NewRequest("POST", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://rei-neuroadapt-api.reilabs.org/api/v1/domains/{domain_id}/value/promote")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body

Get started

Concepts

Guides

Value learning

Planning

Discovery

Operations

API reference

Promote a value candidate

Path, headers, and query

JSON body contract

Request body

ValueCanary

CanaryCase

Responses

​Path, headers, and query

​JSON body contract

​Request body

​ValueCanary

​CanaryCase

​Responses

Path, headers, and query

JSON body contract

Request body

ValueCanary

CanaryCase

Responses