Drives one binding towards its desired state.
const url = 'https://example.com/v1/m/sessions/protocol-bindings/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/reconcile?mode=validate';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"plan_hash":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url 'https://example.com/v1/m/sessions/protocol-bindings/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/reconcile?mode=validate' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "plan_hash": "example" }'Drives one binding towards its desired state. The execution mode is REQUIRED and explicit — validate, plan, test or apply — and an unrecognized one is refused rather than defaulted, so a caller can never reach the applying path by omitting a parameter.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”Path parameter id.
Header Parameters
Section titled “Header Parameters ”Target tenant id; required when the principal can act in more than one tenant.
UUID required when mode=apply; reuse it only for an exact retry.
Strong ProtocolBinding ETag required when mode=apply; when supplied in another mode it must match the current version.
Optional SHA-256 plan hash. It must agree with body.plan_hash when both are supplied and must match the current reconciliation plan.
Query Parameters
Section titled “Query Parameters ”Mandatory reconciliation phase. validate and plan are local and observational; test reads the peer without a local write; apply revalidates and commits the observation.
Request Body
Section titled “Request Body ”Optional reconciliation plan precondition. No body is required in any mode; apply requires If-Match but does not require a plan hash.
object
Optional plan precondition; it must agree with If-Plan-Hash when both are supplied.
Example generated
{ "plan_hash": "example"}Responses
Section titled “ Responses ”OK
object
Example generated
{}Bad request
object
Example generated
{}Unauthenticated
object
Example generated
{}Forbidden
object
Example generated
{}Not found
object
Example generated
{}Conflict / setup required
object
Example generated
{}ETag or plan precondition failed
object
Example generated
{}Strong ETag required for apply
object
Example generated
{}Rate limited
object
Example generated
{}Remote observation is unavailable
object
Example generated
{}