Set Registration Policy
curl --request PUT \
--url https://api.example.com/agents/{agent_id}/registration-policy \
--header 'Content-Type: application/json' \
--data '
{
"require_authenticated_registration": true
}
'import requests
url = "https://api.example.com/agents/{agent_id}/registration-policy"
payload = { "require_authenticated_registration": True }
headers = {"Content-Type": "application/json"}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({require_authenticated_registration: true})
};
fetch('https://api.example.com/agents/{agent_id}/registration-policy', 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.example.com/agents/{agent_id}/registration-policy",
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([
'require_authenticated_registration' => true
]),
CURLOPT_HTTPHEADER => [
"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.example.com/agents/{agent_id}/registration-policy"
payload := strings.NewReader("{\n \"require_authenticated_registration\": true\n}")
req, _ := http.NewRequest("PUT", url, payload)
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.example.com/agents/{agent_id}/registration-policy")
.header("Content-Type", "application/json")
.body("{\n \"require_authenticated_registration\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/agents/{agent_id}/registration-policy")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"require_authenticated_registration\": true\n}"
response = http.request(request)
puts response.read_body{
"agent_id": "<string>",
"require_authenticated_registration": true
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Agents
Set Registration Policy
Enable or clear the per-agent registration requirement. Requires a provider-authenticated principal with agent update permission; agent credentials are refused. Enable only after the agent’s credential is durably delivered to every pod and every serving backend understands the policy. Clearing it is the rollback. Registration and key issuance never change it.
PUT
/
agents
/
{agent_id}
/
registration-policy
Set Registration Policy
curl --request PUT \
--url https://api.example.com/agents/{agent_id}/registration-policy \
--header 'Content-Type: application/json' \
--data '
{
"require_authenticated_registration": true
}
'import requests
url = "https://api.example.com/agents/{agent_id}/registration-policy"
payload = { "require_authenticated_registration": True }
headers = {"Content-Type": "application/json"}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({require_authenticated_registration: true})
};
fetch('https://api.example.com/agents/{agent_id}/registration-policy', 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.example.com/agents/{agent_id}/registration-policy",
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([
'require_authenticated_registration' => true
]),
CURLOPT_HTTPHEADER => [
"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.example.com/agents/{agent_id}/registration-policy"
payload := strings.NewReader("{\n \"require_authenticated_registration\": true\n}")
req, _ := http.NewRequest("PUT", url, payload)
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.example.com/agents/{agent_id}/registration-policy")
.header("Content-Type", "application/json")
.body("{\n \"require_authenticated_registration\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/agents/{agent_id}/registration-policy")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"require_authenticated_registration\": true\n}"
response = http.request(request)
puts response.read_body{
"agent_id": "<string>",
"require_authenticated_registration": true
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Path Parameters
Body
application/json
Set whether this agent's registration requires a bound credential.
True: re-registering this agent requires its own internal API key or a principal with update permission, regardless of the global setting. False: the global setting alone decides. Set it only after the agent's credential is durably delivered to every pod; clearing it is the rollback.

