workflows

Read a workflow preview

External credential scope: read:records. Minimum farm role: EDITOR. Returns the pinned review and, when committed, the saved outcome. Committed receipts survive preview expiry and template archival.

get/v1/farm/{farm_id}/workflows/previews/{preview_id}

Request

  • Base URL: https://api.ranch.bot
  • URL: https://api.ranch.bot/v1/farm/{farm_id}/workflows/previews/{preview_id}
  • Auth: HTTP bearer

Path parameters

farm_idstring uuid required
preview_idstring uuid required

Response

Success

preview_idstring uuid required
template_idstring uuid required
template_versioninteger required
resolved_valuesobject
default_sourcesobject
reviewobject nullable

The stored, authorized review snapshot: dam identity/metadata, dam history, resolved group names, identifier warnings, unresolved facts, and remaining birth-review fields. Null when preparation produced no review. Duplicate identifiers are advisory warnings here, never blocking errors or merges.

preview_hashstring required
expires_atstring date-time
status'pending' | 'invalid' | 'replaced' | 'committed' | 'discarded' required
committed_atstring date-time
saved_entity_idsobject
outcomeobject

Changes

No recorded changes to this operation across all 1 revision of this API.