--- title: "Get Workflow Play Operator Timeline" method: GET path: "/api/plays/{play_id}/operator/timeline" tags: ["plays"] --- # Get Workflow Play Operator Timeline `GET /api/plays/{play_id}/operator/timeline` ## Request - Base URL: `https://platform.verbiflow.com/api/bridge` - URL: `https://platform.verbiflow.com/api/bridge/api/plays/{play_id}/operator/timeline` - Auth: one of: - HTTP bearer and API key in header `x-flage-org-id` - HTTP bearer and API key in header `x-flage-org-slug` ## Path parameters - `play_id` string, required ## Query parameters - `schedule_id` string, nullable - `kind` string[] - `cursor` string, nullable - `limit` integer ## Response `200` Successful Response - WorkflowPlayOperatorTimelineResponse: Cursor-paginated operator timeline for one Play or schedule. - `items` union[], required: Durable events in reverse chronological order, with evidence shaped by kind. - union - WorkflowPlayRevisionTimelineItem: Timeline entry for code revision publication or deletion. - `artifact_id` string, nullable, required: Affected immutable artifact id when present. - `deep_link` string, required: Relative application path for inspecting the affected Play. - `evidence` WorkflowPlayRevisionTimelineEvidence, required: Code revision facts captured by a revision timeline event. - `content_length` integer, nullable, required: Compressed source archive size in bytes when available. - `revision_id` string, required: Immutable revision id referenced by the event. - `source_hash` string, nullable, required: Digest of normalized source when available. - `status` 'ready' | 'deleted', required: Revision lifecycle state at the event. - `id` string, required: Stable timeline item id namespaced by kind. - `kind` 'revision', required: Selects revision-specific evidence. - `occurred_at` string, required: ISO 8601 time of the durable event. - `run_id` string, nullable, required: Affected Workflow Play run id when present. - `schedule_id` string, nullable, required: Affected schedule id when the item is schedule-scoped. - `severity` 'info' | 'success' | 'warning' | 'error', required: Operator-facing visual severity derived from durable state. - `summary` string, required: Sanitized human-readable event summary. - WorkflowPlayEventTimelineItem: Timeline entry for a generic schedule-domain event. - `artifact_id` string, nullable, required: Affected immutable artifact id when present. - `deep_link` string, required: Relative application path for inspecting the affected Play. - `evidence` WorkflowPlayEventTimelineEvidence, required: Generic schedule-domain event identifiers. - `event_type` string, required: Stable domain event name. - `revision_id` string, nullable, required: Affected code revision id when present. - `schedule_id` string, nullable, required: Affected schedule id when the event is schedule-scoped. - `verification_id` string, nullable, required: Affected verification id when present. - `id` string, required: Stable timeline item id namespaced by kind. - `kind` 'event', required: Selects generic domain-event evidence. - `occurred_at` string, required: ISO 8601 time of the durable event. - `run_id` string, nullable, required: Affected Workflow Play run id when present. - `schedule_id` string, nullable, required: Affected schedule id when the item is schedule-scoped. - `severity` 'info' | 'success' | 'warning' | 'error', required: Operator-facing visual severity derived from durable state. - `summary` string, required: Sanitized human-readable event summary. - WorkflowPlayVerificationTimelineItem: Timeline entry for verification lifecycle changes. - `artifact_id` string, nullable, required: Affected immutable artifact id when present. - `deep_link` string, required: Relative application path for inspecting the affected Play. - `evidence` WorkflowPlayVerificationTimelineEvidence, required: Verification lifecycle facts shown on the operator timeline. - `expires_at` string, required: ISO 8601 expiry time for the verification proof. - `preview_tick_id` string, required: Schedule tick used for the verification preview. - `revision_id` string, required: Candidate revision verified by the preview. - `status` 'pending' | 'passed' | 'failed', required: Verification state at the timeline event. - `verification_id` string, required: Stable verification request id. - `id` string, required: Stable timeline item id namespaced by kind. - `kind` 'verification', required: Selects verification-specific evidence. - `occurred_at` string, required: ISO 8601 time of the durable event. - `run_id` string, nullable, required: Affected Workflow Play run id when present. - `schedule_id` string, nullable, required: Affected schedule id when the item is schedule-scoped. - `severity` 'info' | 'success' | 'warning' | 'error', required: Operator-facing visual severity derived from durable state. - `summary` string, required: Sanitized human-readable event summary. - WorkflowPlayTickTimelineItem: Timeline entry for schedule occurrence lifecycle changes. - `artifact_id` string, nullable, required: Affected immutable artifact id when present. - `deep_link` string, required: Relative application path for inspecting the affected Play. - `evidence` WorkflowPlayTickTimelineEvidence, required: Schedule occurrence facts shown on the operator timeline. - `error_code` string, nullable, required: Stable sanitized terminal failure code when present. - `scheduled_for` string, required: ISO 8601 logical occurrence time. - `status` 'queued' | 'running' | 'blocked' | 'completed' | 'failed' | 'skipped' | 'rejected', required: Tick state at the timeline event. - `tick_id` string, required: Stable schedule occurrence id. - `trigger_type` 'scheduled' | 'manual_run' | 'verification_preview' | 'event', required: Clock, operator, verification, or provider-event admission source. - `workflow_progress_run_id` string, nullable, required: Progress-stream run id after execution admission. - `id` string, required: Stable timeline item id namespaced by kind. - `kind` 'tick', required: Selects schedule-tick evidence. - `occurred_at` string, required: ISO 8601 time of the durable event. - `run_id` string, nullable, required: Affected Workflow Play run id when present. - `schedule_id` string, nullable, required: Affected schedule id when the item is schedule-scoped. - `severity` 'info' | 'success' | 'warning' | 'error', required: Operator-facing visual severity derived from durable state. - `summary` string, required: Sanitized human-readable event summary. - WorkflowPlayRunTimelineItem: Timeline entry for Workflow Play execution state. - `artifact_id` string, nullable, required: Affected immutable artifact id when present. - `deep_link` string, required: Relative application path for inspecting the affected Play. - `evidence` WorkflowPlayRunTimelineEvidence, required: Workflow Play execution facts shown on the operator timeline. - `mode` string, required: Execution mode recorded for the run. - `resolved_code_revision_id` string, nullable, required: Immutable code revision resolved for execution. - `run_id` string, required: Durable Workflow Play run id. - `status` string, required: Run lifecycle state recorded by the executor. - `tick_id` string, nullable, required: Schedule tick that owns the run when scheduled. - `id` string, required: Stable timeline item id namespaced by kind. - `kind` 'run', required: Selects run-specific evidence. - `occurred_at` string, required: ISO 8601 time of the durable event. - `run_id` string, nullable, required: Affected Workflow Play run id when present. - `schedule_id` string, nullable, required: Affected schedule id when the item is schedule-scoped. - `severity` 'info' | 'success' | 'warning' | 'error', required: Operator-facing visual severity derived from durable state. - `summary` string, required: Sanitized human-readable event summary. - WorkflowPlayStepTimelineItem: Timeline entry for progress within a Workflow Play run. - `artifact_id` string, nullable, required: Affected immutable artifact id when present. - `deep_link` string, required: Relative application path for inspecting the affected Play. - `evidence` WorkflowPlayStepTimelineEvidence, required: One executor step progress event. - `label` string, nullable, required: Human-readable step label when supplied by the executor. - `run_id` string, required: Workflow Play run that emitted the step event. - `status` string, nullable, required: Step lifecycle state when supplied by the executor. - `step_id` string, nullable, required: Revision-defined step id when supplied by the executor. - `tick_id` string, nullable, required: Owning schedule tick for a scheduled run. - `id` string, required: Stable timeline item id namespaced by kind. - `kind` 'step', required: Selects executor-step evidence. - `occurred_at` string, required: ISO 8601 time of the durable event. - `run_id` string, nullable, required: Affected Workflow Play run id when present. - `schedule_id` string, nullable, required: Affected schedule id when the item is schedule-scoped. - `severity` 'info' | 'success' | 'warning' | 'error', required: Operator-facing visual severity derived from durable state. - `summary` string, required: Sanitized human-readable event summary. - WorkflowPlayAuthorityTimelineItem: Timeline entry for durable member-authority changes. - `artifact_id` string, nullable, required: Affected immutable artifact id when present. - `deep_link` string, required: Relative application path for inspecting the affected Play. - `evidence` WorkflowPlayAuthorityTimelineEvidence, required: Member-authority grant state shown on the operator timeline. - `definition_digest` string, required: Schedule and revision definition authorized by the grant. - `grant_id` string, required: Stable durable authority grant id. - `grant_version` integer, required: Monotonic grant version used to fence work. - `revocation_reason` string, nullable, required: Sanitized reason recorded when authority was revoked. - `revoked_at` string, nullable, required: ISO 8601 revocation time when revoked. - `status` 'active' | 'revoked' | 'superseded', required: Authority grant lifecycle state. - `id` string, required: Stable timeline item id namespaced by kind. - `kind` 'authority', required: Selects authority-grant evidence. - `occurred_at` string, required: ISO 8601 time of the durable event. - `run_id` string, nullable, required: Affected Workflow Play run id when present. - `schedule_id` string, nullable, required: Affected schedule id when the item is schedule-scoped. - `severity` 'info' | 'success' | 'warning' | 'error', required: Operator-facing visual severity derived from durable state. - `summary` string, required: Sanitized human-readable event summary. - WorkflowPlayStateCommitTimelineItem: Timeline entry for an atomic schedule-state commit. - `artifact_id` string, nullable, required: Affected immutable artifact id when present. - `deep_link` string, required: Relative application path for inspecting the affected Play. - `evidence` WorkflowPlayStateCommitTimelineEvidence, required: Atomic durable state commit produced by one schedule tick. - `commit_id` string, required: Stable idempotent state commit id. - `delete_count` integer, required: Number of state keys deleted. - `new_generation` integer, required: Schedule-state generation after the commit. - `signal_count` integer, required: Number of notification signals staged with the commit. - `tick_id` string, required: Schedule tick that authored the commit. - `upsert_count` integer, required: Number of state keys inserted or replaced. - `id` string, required: Stable timeline item id namespaced by kind. - `kind` 'state_commit', required: Selects schedule-state commit evidence. - `occurred_at` string, required: ISO 8601 time of the durable event. - `run_id` string, nullable, required: Affected Workflow Play run id when present. - `schedule_id` string, nullable, required: Affected schedule id when the item is schedule-scoped. - `severity` 'info' | 'success' | 'warning' | 'error', required: Operator-facing visual severity derived from durable state. - `summary` string, required: Sanitized human-readable event summary. - WorkflowPlayEffectTimelineItem: Timeline entry for provider-effect admission or receipt state. - `artifact_id` string, nullable, required: Affected immutable artifact id when present. - `deep_link` string, required: Relative application path for inspecting the affected Play. - `evidence` union, required: Effect admission or provider-boundary receipt facts. - WorkflowPlayEffectReceiptTimelineEvidence: Provider-effect receipt state after an effect has been prepared. - `capability` string, required: Hosted SDK capability that owns the provider operation. - `lifecycle` 'prepared' | 'dispatched' | 'succeeded' | 'retryable_failed' | 'unknown', required: Durable provider-boundary lifecycle state. - `provider_operation_id` string, nullable, required: Provider operation id when dispatch returned one. - `semantic_effect_key` string, required: Stable semantic identity that deduplicates the provider effect. - `tick_id` string, required: Schedule tick that owns the effect. - WorkflowPlayEffectAdmissionTimelineEvidence: Effect admission before a provider-boundary receipt exists. - `capability` string, required: Hosted SDK capability requested by the workflow. - `lease_fence` integer, required: Execution lease generation that fenced the admission. - `lifecycle` 'admitted', required: Confirms that the effect entered the durable admission ledger. - `revision_id` string, required: Immutable code revision that requested the effect. - `semantic_effect_key` string, required: Stable semantic identity that deduplicates the requested effect. - `tick_id` string, required: Schedule tick that admitted the effect. - `id` string, required: Stable timeline item id namespaced by kind. - `kind` 'effect', required: Selects durable effect evidence. - `occurred_at` string, required: ISO 8601 time of the durable event. - `run_id` string, nullable, required: Affected Workflow Play run id when present. - `schedule_id` string, nullable, required: Affected schedule id when the item is schedule-scoped. - `severity` 'info' | 'success' | 'warning' | 'error', required: Operator-facing visual severity derived from durable state. - `summary` string, required: Sanitized human-readable event summary. - WorkflowPlayApprovalTimelineItem: Timeline entry for a human effect-approval request. - `artifact_id` string, nullable, required: Affected immutable artifact id when present. - `deep_link` string, required: Relative application path for inspecting the affected Play. - `evidence` WorkflowPlayApprovalTimelineEvidence, required: Human approval state for one requested workflow effect. - `approval_id` string, required: Stable approval request id. - `decided_at` string, nullable, required: ISO 8601 decision time, or null while pending. - `effect` string, required: Sanitized effect summary presented to the reviewer. - `status` 'pending' | 'approved' | 'rejected', required: Approval decision state. - `tick_id` string, nullable, required: Schedule tick that requested approval when scheduled. - `id` string, required: Stable timeline item id namespaced by kind. - `kind` 'approval', required: Selects human-approval evidence. - `occurred_at` string, required: ISO 8601 time of the durable event. - `run_id` string, nullable, required: Affected Workflow Play run id when present. - `schedule_id` string, nullable, required: Affected schedule id when the item is schedule-scoped. - `severity` 'info' | 'success' | 'warning' | 'error', required: Operator-facing visual severity derived from durable state. - `summary` string, required: Sanitized human-readable event summary. - WorkflowPlayArtifactTimelineItem: Timeline entry for a published Workflow Play output. - `artifact_id` string, nullable, required: Affected immutable artifact id when present. - `deep_link` string, required: Relative application path for inspecting the affected Play. - `evidence` WorkflowPlayArtifactTimelineEvidence, required: Published output artifact produced by a Workflow Play run. - `artifact_id` string, required: Immutable artifact id containing the output bytes. - `kind` string, nullable, required: Revision-defined output kind when supplied. - `label` string, nullable, required: Human-readable output label when supplied. - `output_id` string, required: Stable run-output record id. - `id` string, required: Stable timeline item id namespaced by kind. - `kind` 'artifact', required: Selects output-artifact evidence. - `occurred_at` string, required: ISO 8601 time of the durable event. - `run_id` string, nullable, required: Affected Workflow Play run id when present. - `schedule_id` string, nullable, required: Affected schedule id when the item is schedule-scoped. - `severity` 'info' | 'success' | 'warning' | 'error', required: Operator-facing visual severity derived from durable state. - `summary` string, required: Sanitized human-readable event summary. - WorkflowPlaySignalTimelineItem: Timeline entry for a durable workflow notification signal. - `artifact_id` string, nullable, required: Affected immutable artifact id when present. - `deep_link` string, required: Relative application path for inspecting the affected Play. - `evidence` WorkflowPlaySignalTimelineEvidence, required: Notification signal atomically staged with schedule state. - `commit_id` string, required: State commit that made the signal durable. - `namespace` string, required: Revision-defined notification stream namespace. - `signal_key` string, required: Stable notification signal identity. - `subject_key` string, required: Revision-defined subject identity within the namespace. - `tick_id` string, required: Schedule tick that emitted the signal. - `id` string, required: Stable timeline item id namespaced by kind. - `kind` 'signal', required: Selects workflow-signal evidence. - `occurred_at` string, required: ISO 8601 time of the durable event. - `run_id` string, nullable, required: Affected Workflow Play run id when present. - `schedule_id` string, nullable, required: Affected schedule id when the item is schedule-scoped. - `severity` 'info' | 'success' | 'warning' | 'error', required: Operator-facing visual severity derived from durable state. - `summary` string, required: Sanitized human-readable event summary. - WorkflowPlayNotificationTimelineItem: Timeline entry for a notification event derived from a signal. - `artifact_id` string, nullable, required: Affected immutable artifact id when present. - `deep_link` string, required: Relative application path for inspecting the affected Play. - `evidence` WorkflowPlayNotificationTimelineEvidence, required: Notification event emitted from a durable workflow signal. - `commit_id` string, nullable, required: Originating state commit id when available. - `document_digest` string, nullable, required: Digest of the canonical notification document when rendered. - `event_id` string, required: Stable notification event id. - `event_key` string, required: Notification routing key. - `renderer_digest` string, nullable, required: Digest of the renderer contract when rendered. - `signal_key` string, nullable, required: Originating workflow signal identity when available. - `tick_id` string, nullable, required: Originating schedule tick id when available. - `id` string, required: Stable timeline item id namespaced by kind. - `kind` 'notification', required: Selects notification-event evidence. - `occurred_at` string, required: ISO 8601 time of the durable event. - `run_id` string, nullable, required: Affected Workflow Play run id when present. - `schedule_id` string, nullable, required: Affected schedule id when the item is schedule-scoped. - `severity` 'info' | 'success' | 'warning' | 'error', required: Operator-facing visual severity derived from durable state. - `summary` string, required: Sanitized human-readable event summary. - WorkflowPlayDeliveryTimelineItem: Timeline entry for Slack notification delivery state. - `artifact_id` string, nullable, required: Affected immutable artifact id when present. - `deep_link` string, required: Relative application path for inspecting the affected Play. - `evidence` WorkflowPlayDeliveryTimelineEvidence, required: Slack delivery state for one notification event or digest. - `attempt_count` integer, required: Number of delivery attempts recorded. - `delivery_id` string, required: Stable notification delivery id. - `sent_at` string, nullable, required: ISO 8601 successful delivery time, or null before delivery. - `slack_channel_id` string, nullable, required: Slack channel id selected for delivery. - `slack_message_ts` string, nullable, required: Slack message timestamp after a message is posted. - `slack_team_id` string, nullable, required: Slack workspace id selected for delivery. - `status` 'pending' | 'analyzing' | 'posting' | 'sent' | 'suppressed' | 'failed', required: Current delivery lifecycle state. - `id` string, required: Stable timeline item id namespaced by kind. - `kind` 'delivery', required: Selects notification-delivery evidence. - `occurred_at` string, required: ISO 8601 time of the durable event. - `run_id` string, nullable, required: Affected Workflow Play run id when present. - `schedule_id` string, nullable, required: Affected schedule id when the item is schedule-scoped. - `severity` 'info' | 'success' | 'warning' | 'error', required: Operator-facing visual severity derived from durable state. - `summary` string, required: Sanitized human-readable event summary. - `next_cursor` string, nullable, required: Opaque cursor for the next older page, or null at the end. ## Other responses - `422`: Validation Error --- [API](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract.md) - [All operations](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/llms.txt) - [OpenAPI document](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/revisions/c80e903ef8f3?raw)