Apply a proposal — the diff is recomputed and compared before writing
Applies a diff produced by a propose capability.
Applies a diff produced by a propose capability. The diff is recomputed and compared against the stored one before anything is written — this is the only write path, and it refuses rather than overwrites.
A proposal is applied once. diff_stale means someone — a person or another agent — changed the target between the proposal and the apply, and applying now would silently discard their change. It is the most common refusal here, and it is a safety net, not a fault: recompute and review the fresh diff.
Publishing to an external network is never part of this. No capability declares it; it stays a human gesture.
/v1/proposals/{proposalId}/applyAuthorization
agent-token An agent project token. Obtained by OAuth consent for an AI client, or derived per project from an organisation service key for a machine. A scoped API key authenticates the transport but opens no capability: a capability takes its project from the credential.
In: header
Path Parameters
The proposal to apply, as returned by the propose capability that computed it. A proposal belongs to the principal that created it and is applied once.
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://app.digitalyser.io/api/v1/proposals/550e8400-e29b-41d4-a716-446655440000/apply" \ -H "Authorization: Bearer <token>"{ "capabilityId": "audit.overview.get", "projectId": "8f14e45f-ea0e-4b1e-9b7a-2c3d4e5f6071", "resultType": "value", "data": { "schemaVersion": "2" }}Generated from the capability registry — API version 1, 18 paths, from 4815355 (2026-10-12).