POST /api/v1/ceremonies/{ceremony_id}/confirm
Confirm a ceremony with a ceremony capability
Records the candidate human's confirmation that the SAS words match, spending the ceremony capability sent in the X-AgentPeer-Ceremony header, and returns the ceremony's new status. The body's ceremony_id must match the path. A capability that was already used, an expired ceremony, or a ceremony_id mismatch returns conflict; an unknown ceremony returns not_found.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
ceremony_id | path | yes | string (uuid) |
Request body
Required.
application/json: CeremonyDecision
| Property | Type | Required | Description |
|---|---|---|---|
ceremony_id | string (uuid) | yes |
Responses
200 Successful Response
application/json: Not described in the contract
422 Validation Error
application/json: HTTPValidationError
| Property | Type | Required | Description |
|---|---|---|---|
detail | array of ValidationError | no |
Error responses follow the error registry, errors-v1.md; the Errors section explains each code.
Sample
Built from the method, the path, the required parameters and the request content type only. Replace each placeholder in braces or angle brackets. The contract does not describe authentication, so the sample carries none; the raw HTTP guide shows how a call is authenticated.
curl -X POST 'https://agentpeer.io/api/v1/ceremonies/{ceremony_id}/confirm' \
-H 'content-type: application/json' \
--data '<CeremonyDecision>'Source: openapi-v1.json, operation confirm_ceremony_api_v1_ceremonies__ceremony_id__confirm_post