Prepare a single-label Persona
curl --request POST \
--url https://api.example.com/personas/{persona}/named/prepare \
--header 'Content-Type: application/json' \
--data '
{
"action": "<string>",
"operator_did": "<string>",
"controller_keys": [
"<string>"
],
"controller_threshold": 123,
"nonce": "<string>",
"valid_until": "<string>",
"signer_key_id": "<string>"
}
'import requests
url = "https://api.example.com/personas/{persona}/named/prepare"
payload = {
"action": "<string>",
"operator_did": "<string>",
"controller_keys": ["<string>"],
"controller_threshold": 123,
"nonce": "<string>",
"valid_until": "<string>",
"signer_key_id": "<string>"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
action: '<string>',
operator_did: '<string>',
controller_keys: ['<string>'],
controller_threshold: 123,
nonce: '<string>',
valid_until: '<string>',
signer_key_id: '<string>'
})
};
fetch('https://api.example.com/personas/{persona}/named/prepare', 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/personas/{persona}/named/prepare",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'action' => '<string>',
'operator_did' => '<string>',
'controller_keys' => [
'<string>'
],
'controller_threshold' => 123,
'nonce' => '<string>',
'valid_until' => '<string>',
'signer_key_id' => '<string>'
]),
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/personas/{persona}/named/prepare"
payload := strings.NewReader("{\n \"action\": \"<string>\",\n \"operator_did\": \"<string>\",\n \"controller_keys\": [\n \"<string>\"\n ],\n \"controller_threshold\": 123,\n \"nonce\": \"<string>\",\n \"valid_until\": \"<string>\",\n \"signer_key_id\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", 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.post("https://api.example.com/personas/{persona}/named/prepare")
.header("Content-Type", "application/json")
.body("{\n \"action\": \"<string>\",\n \"operator_did\": \"<string>\",\n \"controller_keys\": [\n \"<string>\"\n ],\n \"controller_threshold\": 123,\n \"nonce\": \"<string>\",\n \"valid_until\": \"<string>\",\n \"signer_key_id\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/personas/{persona}/named/prepare")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"action\": \"<string>\",\n \"operator_did\": \"<string>\",\n \"controller_keys\": [\n \"<string>\"\n ],\n \"controller_threshold\": 123,\n \"nonce\": \"<string>\",\n \"valid_until\": \"<string>\",\n \"signer_key_id\": \"<string>\"\n}"
response = http.request(request)
puts response.read_bodyPersonas
Prepare a single-label Persona
Prepare a DID-signed Persona registration without DNS proof
Prepare a single-label Persona
curl --request POST \
--url https://api.example.com/personas/{persona}/named/prepare \
--header 'Content-Type: application/json' \
--data '
{
"action": "<string>",
"operator_did": "<string>",
"controller_keys": [
"<string>"
],
"controller_threshold": 123,
"nonce": "<string>",
"valid_until": "<string>",
"signer_key_id": "<string>"
}
'import requests
url = "https://api.example.com/personas/{persona}/named/prepare"
payload = {
"action": "<string>",
"operator_did": "<string>",
"controller_keys": ["<string>"],
"controller_threshold": 123,
"nonce": "<string>",
"valid_until": "<string>",
"signer_key_id": "<string>"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
action: '<string>',
operator_did: '<string>',
controller_keys: ['<string>'],
controller_threshold: 123,
nonce: '<string>',
valid_until: '<string>',
signer_key_id: '<string>'
})
};
fetch('https://api.example.com/personas/{persona}/named/prepare', 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/personas/{persona}/named/prepare",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'action' => '<string>',
'operator_did' => '<string>',
'controller_keys' => [
'<string>'
],
'controller_threshold' => 123,
'nonce' => '<string>',
'valid_until' => '<string>',
'signer_key_id' => '<string>'
]),
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/personas/{persona}/named/prepare"
payload := strings.NewReader("{\n \"action\": \"<string>\",\n \"operator_did\": \"<string>\",\n \"controller_keys\": [\n \"<string>\"\n ],\n \"controller_threshold\": 123,\n \"nonce\": \"<string>\",\n \"valid_until\": \"<string>\",\n \"signer_key_id\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", 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.post("https://api.example.com/personas/{persona}/named/prepare")
.header("Content-Type", "application/json")
.body("{\n \"action\": \"<string>\",\n \"operator_did\": \"<string>\",\n \"controller_keys\": [\n \"<string>\"\n ],\n \"controller_threshold\": 123,\n \"nonce\": \"<string>\",\n \"valid_until\": \"<string>\",\n \"signer_key_id\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/personas/{persona}/named/prepare")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"action\": \"<string>\",\n \"operator_did\": \"<string>\",\n \"controller_keys\": [\n \"<string>\"\n ],\n \"controller_threshold\": 123,\n \"nonce\": \"<string>\",\n \"valid_until\": \"<string>\",\n \"signer_key_id\": \"<string>\"\n}"
response = http.request(request)
puts response.read_bodyUse this route for a unique single-label Persona such as
You may include
compliance. A name containing a dot uses the DNS challenge flow. The operator DID must be active, and every controller key must be one of its published signing keys.
Request
Optional current Persona operator nonce. The new Directory release reads it from finalized state when omitted and returns it with the prepared payload. Keep the returned nonce in the signed submission.
delivery_constraints with requested limits. Do not include the read-only effective_ttl_seconds.
The 200 response returns persona, operator_did, signer_key_id, and canonical_payload as 0x-prefixed hexadecimal. Decode and sign those bytes locally, then submit the registration. Preparation checks that the Persona is not already registered; it does not reserve the name.
Straight to the point
POST /personas/{persona}/named/prepare
Name: one label, no DNS challenge
Success: 200 with canonical_payload to sign

