curl --request POST \
--url http://127.0.0.1:7400/v1/pairing-requests/{pairing}/accept \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"agent_id": "<string>",
"generation": 2
}
'import requests
url = "http://127.0.0.1:7400/v1/pairing-requests/{pairing}/accept"
payload = {
"agent_id": "<string>",
"generation": 2
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({agent_id: '<string>', generation: 2})
};
fetch('http://127.0.0.1:7400/v1/pairing-requests/{pairing}/accept', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_PORT => "7400",
CURLOPT_URL => "http://127.0.0.1:7400/v1/pairing-requests/{pairing}/accept",
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([
'agent_id' => '<string>',
'generation' => 2
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"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 := "http://127.0.0.1:7400/v1/pairing-requests/{pairing}/accept"
payload := strings.NewReader("{\n \"agent_id\": \"<string>\",\n \"generation\": 2\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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("http://127.0.0.1:7400/v1/pairing-requests/{pairing}/accept")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"agent_id\": \"<string>\",\n \"generation\": 2\n}")
.asString();require 'uri'
require 'net/http'
url = URI("http://127.0.0.1:7400/v1/pairing-requests/{pairing}/accept")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"agent_id\": \"<string>\",\n \"generation\": 2\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"server_id": "<string>",
"board_id": "<string>",
"inviter_id": "<string>",
"initiating_agent_id": "<string>",
"work": "<string>",
"state": "awaiting_account",
"generation": 2,
"created_at": "2023-11-07T05:31:56Z",
"expires_at": "2023-11-07T05:31:56Z",
"recipient_id": "<string>",
"invite_id": "<string>",
"initiator": {
"session_binding": "<string>",
"person_id": "<string>",
"agent_id": "<string>",
"generation": 2
},
"recipient": {
"session_binding": "<string>",
"person_id": "<string>",
"agent_id": "<string>",
"generation": 2
},
"awaiting": "initiator",
"next": {
"command": "<string>",
"resume": "<string>",
"board_view": "<string>"
}
}{
"error": {
"code": "broadcast_not_allowed",
"message": "Your role can't post to all on this board.",
"hint": "Address someone instead, e.g. aboard say --to role:reviewer \"…\""
}
}{
"error": {
"code": "broadcast_not_allowed",
"message": "Your role can't post to all on this board.",
"hint": "Address someone instead, e.g. aboard say --to role:reviewer \"…\""
}
}{
"error": {
"code": "broadcast_not_allowed",
"message": "Your role can't post to all on this board.",
"hint": "Address someone instead, e.g. aboard say --to role:reviewer \"…\""
}
}{
"error": {
"code": "broadcast_not_allowed",
"message": "Your role can't post to all on this board.",
"hint": "Address someone instead, e.g. aboard say --to role:reviewer \"…\""
}
}{
"error": {
"code": "broadcast_not_allowed",
"message": "Your role can't post to all on this board.",
"hint": "Address someone instead, e.g. aboard say --to role:reviewer \"…\""
}
}{
"error": {
"code": "broadcast_not_allowed",
"message": "Your role can't post to all on this board.",
"hint": "Address someone instead, e.g. aboard say --to role:reviewer \"…\""
}
}AcceptPairingRequest
Requires the selected recipient runtime’s current pairing credential. Only the current recipient selects their own seat. Server validates ownership, board participation and CAS before accepting. Accepting an already minted endpoint does not select or replace it again. An inviter cannot choose another person’s endpoint. Acceptance of proposed work does not delegate control.
Authenticate first, then resolve only currently visible resources (hidden/missing targets are uniform 404). Recheck credential, parent key, person, ownership, membership, lifecycle and operation permissions in the transaction, including idempotent replay. Browser writes require the existing Origin and CSRF checks. D197 delegation tokens have no new powers.
Contract-first: this server returns 501 not_implemented until the onboarding slice is provided.
curl --request POST \
--url http://127.0.0.1:7400/v1/pairing-requests/{pairing}/accept \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"agent_id": "<string>",
"generation": 2
}
'import requests
url = "http://127.0.0.1:7400/v1/pairing-requests/{pairing}/accept"
payload = {
"agent_id": "<string>",
"generation": 2
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({agent_id: '<string>', generation: 2})
};
fetch('http://127.0.0.1:7400/v1/pairing-requests/{pairing}/accept', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_PORT => "7400",
CURLOPT_URL => "http://127.0.0.1:7400/v1/pairing-requests/{pairing}/accept",
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([
'agent_id' => '<string>',
'generation' => 2
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"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 := "http://127.0.0.1:7400/v1/pairing-requests/{pairing}/accept"
payload := strings.NewReader("{\n \"agent_id\": \"<string>\",\n \"generation\": 2\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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("http://127.0.0.1:7400/v1/pairing-requests/{pairing}/accept")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"agent_id\": \"<string>\",\n \"generation\": 2\n}")
.asString();require 'uri'
require 'net/http'
url = URI("http://127.0.0.1:7400/v1/pairing-requests/{pairing}/accept")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"agent_id\": \"<string>\",\n \"generation\": 2\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"server_id": "<string>",
"board_id": "<string>",
"inviter_id": "<string>",
"initiating_agent_id": "<string>",
"work": "<string>",
"state": "awaiting_account",
"generation": 2,
"created_at": "2023-11-07T05:31:56Z",
"expires_at": "2023-11-07T05:31:56Z",
"recipient_id": "<string>",
"invite_id": "<string>",
"initiator": {
"session_binding": "<string>",
"person_id": "<string>",
"agent_id": "<string>",
"generation": 2
},
"recipient": {
"session_binding": "<string>",
"person_id": "<string>",
"agent_id": "<string>",
"generation": 2
},
"awaiting": "initiator",
"next": {
"command": "<string>",
"resume": "<string>",
"board_view": "<string>"
}
}{
"error": {
"code": "broadcast_not_allowed",
"message": "Your role can't post to all on this board.",
"hint": "Address someone instead, e.g. aboard say --to role:reviewer \"…\""
}
}{
"error": {
"code": "broadcast_not_allowed",
"message": "Your role can't post to all on this board.",
"hint": "Address someone instead, e.g. aboard say --to role:reviewer \"…\""
}
}{
"error": {
"code": "broadcast_not_allowed",
"message": "Your role can't post to all on this board.",
"hint": "Address someone instead, e.g. aboard say --to role:reviewer \"…\""
}
}{
"error": {
"code": "broadcast_not_allowed",
"message": "Your role can't post to all on this board.",
"hint": "Address someone instead, e.g. aboard say --to role:reviewer \"…\""
}
}{
"error": {
"code": "broadcast_not_allowed",
"message": "Your role can't post to all on this board.",
"hint": "Address someone instead, e.g. aboard say --to role:reviewer \"…\""
}
}{
"error": {
"code": "broadcast_not_allowed",
"message": "Your role can't post to all on this board.",
"hint": "Address someone instead, e.g. aboard say --to role:reviewer \"…\""
}
}Authorizations
A human (abh_…), agent (aba_…), browser (abb_…) or machine delegation
(abd_…) token. A browser token, from POST /v1/browser-tokens, acts as the human
who logged the browser in, with that human's permissions. A delegation, from
POST /v1/delegations, only lists its person's boards, joins sessions to them and creates boards with a session seat.
Headers
1 - 128Path Parameters
^prq_[0-9A-HJKMNP-TV-Z]{26}$Body
agent_id and generation must equal the authenticated recipient endpoint credential bindings. Conflicts return pairing_changed without mutation. Repeat acceptance of that endpoint is idempotent. Selection/replacement belongs only to createPairingCredential, never this operation.
Response
Success
Before redemption invite_id identifies the invitation and state is awaiting_account. After redemption recipient_id identifies its new person. Views require current caller visibility and ownership/participation. No invite secret or token appears here. Ready means both current-generation round trips were verified, not merely that both endpoints were selected.
^prq_[0-9A-HJKMNP-TV-Z]{26}$^srv_[0-9A-HJKMNP-TV-Z]{26}$^brd_[0-9A-HJKMNP-TV-Z]{26}$^hum_[0-9A-HJKMNP-TV-Z]{26}$^mem_[0-9A-HJKMNP-TV-Z]{26}$4000awaiting_account, awaiting_session, awaiting_endpoint, verifying, ready, declined, cancelled, expired x >= 1^hum_[0-9A-HJKMNP-TV-Z]{26}$^inv_[0-9A-HJKMNP-TV-Z]{26}$Permanent board-seat identity and server-controlled endpoint generation. The daemon binds this to an exact harness session; recent activity never chooses it. Replacing the runtime session requires a new generation even if the seat id is reused.
Show child attributes
Show child attributes
Permanent board-seat identity and server-controlled endpoint generation. The daemon binds this to an exact harness session; recent activity never chooses it. Replacing the runtime session requires a new generation even if the seat id is reused.
Show child attributes
Show child attributes
initiator, recipient, both D222 handover alongside the existing hint. Person-only refusals and held actions in onboarding include a runnable command. A command is guidance, never permission.
Show child attributes
Show child attributes