Preview Publish federated intelligence program (dry-run)
const url = 'https://api.aerandil.com/v1/actions/hospitality.action.publish_federated_program/preview';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"branch":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","params":{"allowed_analysis_kinds":["federated_analytics"],"allowed_output_kinds":["benchmark_report"],"api_name":"example","coordinator_kind":"aerandil","coordinator_reference":"example","default_delta":"example","default_epsilon":"example","default_max_contributor_share":"example","default_min_properties":1,"default_min_subjects":1,"default_min_tenants":1,"default_privacy_mechanisms":["cohort_threshold"],"description":"example","display_name":"example","downstream_use_policy":"example","dpa_reference":"example","dpia_reference":"example","effective_from":"2026-04-15T12:00:00Z","effective_to":"2026-04-15T12:00:00Z","governance_tier":"internal_portfolio","legal_basis_summary":"example","minimum_local_runner_version":"example","owner_ref":"example","owner_scope":"tenant","participant_benefit_policy":"example","privacy_budget_period":"run","publish_status":"draft","purpose":"rate_recommendation_calibration","recommended_local_runner_version":"example","review_gate_policy":"example"},"return_modified":false,"target":{"id":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","object_type":"hospitality.property"}}'};
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://api.aerandil.com/v1/actions/hospitality.action.publish_federated_program/preview \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "branch": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "params": { "allowed_analysis_kinds": [ "federated_analytics" ], "allowed_output_kinds": [ "benchmark_report" ], "api_name": "example", "coordinator_kind": "aerandil", "coordinator_reference": "example", "default_delta": "example", "default_epsilon": "example", "default_max_contributor_share": "example", "default_min_properties": 1, "default_min_subjects": 1, "default_min_tenants": 1, "default_privacy_mechanisms": [ "cohort_threshold" ], "description": "example", "display_name": "example", "downstream_use_policy": "example", "dpa_reference": "example", "dpia_reference": "example", "effective_from": "2026-04-15T12:00:00Z", "effective_to": "2026-04-15T12:00:00Z", "governance_tier": "internal_portfolio", "legal_basis_summary": "example", "minimum_local_runner_version": "example", "owner_ref": "example", "owner_scope": "tenant", "participant_benefit_policy": "example", "privacy_budget_period": "run", "publish_status": "draft", "purpose": "rate_recommendation_calibration", "recommended_local_runner_version": "example", "review_gate_policy": "example" }, "return_modified": false, "target": { "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "object_type": "hospitality.property" } }'Scenario preview of apply_hospitality_action_publish_federated_program — runs the action exactly as apply would (validation, handler dispatch, modified-object projection, commit-time cross-link validation) then rolls the transaction back. Returns the modified_objects / modified_links / warnings the apply would have produced without persisting anything or firing any outward effect. Requires the same actions:hospitality.action.publish_federated_program:apply scope as apply. No Idempotency-Key.
Authorizations
Section titled “Authorizations”Request Bodyrequired
Section titled “Request Bodyrequired”object
Apply against an open branch’s overlay view instead of the canonical (main) plane. The action’s writes land in the branch’s copy-on-first-write overlay, its events in the branch’s own stream, and the invocation is journaled for merge-by-replay. Branch writes are action-only, so this is the write-side entry point to a branch (POST /v1/branches forks one).
object
When true, the response carries modified_objects and modified_links projections — the engine reads the event log inside the same transaction so the projection observes the handler’s own writes.
object
Responses
Section titled “Responses”Preview computed and rolled back. modified_objects and modified_links carry the effect set the apply would produce; preview is always true.
Envelope returned by the Aerandil action engine. correlation_id ties every event emitted by this invocation; modified_objects and modified_links project the events the handler emitted (per the action’s declared effects); warnings carries any non-blocking soft-validator observations.
object
Per-invocation correlation id; matches events.correlation_id for every event this action appended.
Links established or removed by this invocation. Empty when the caller did not request return_modified.
object
Objects created, modified, or soft-deleted by this invocation. Empty when the caller did not request return_modified.
object
Non-blocking soft-validator observations emitted during this invocation (e.g. comp-authority over-limit, recipe pour-cost over sell-price). Absent when no warnings were emitted.
object
Human-readable summary, suitable for logging or operator-UI surfacing.
Object type the warning was raised against.
Property the warning anchors to, when a single field is the locus. Absent for multi-field rules.
Stable kebab-case rule identifier (e.g. comp-authority-over-limit).
Example
{ "modified_links": [ { "kind": "linked" } ], "modified_objects": [ { "kind": "created", "object_type": "hospitality.federated_intelligence_program" } ]}Headers
Section titled “Headers”Always no-store — uncommitted live data.
Conflict — concurrent modification or unique constraint violation the apply would hit.
Validation error — the apply would be rejected.