---
title: "Get Workflow Play Schedule Tick"
method: GET
path: "/api/plays/{play_id}/schedule-ticks/{tick_id}"
tags: ["plays"]
---

# Get Workflow Play Schedule Tick

`GET /api/plays/{play_id}/schedule-ticks/{tick_id}`

## Request

- Base URL: `https://platform.verbiflow.com/api/bridge`
- URL: `https://platform.verbiflow.com/api/bridge/api/plays/{play_id}/schedule-ticks/{tick_id}`
- 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
- `tick_id` string, required

## Response `200`

Successful Response

- WorkflowPlayScheduleTickResponse: Envelope returned by operations that admit or read one schedule tick.
  - `tick` WorkflowPlayScheduleTickRecord, required: One durable occurrence admitted by a Play schedule.
    - `completed_at` string, nullable, required: ISO 8601 terminal time.
    - `created_at` string, required: ISO 8601 admission time.
    - `delivery_target` WorkflowPlayScheduleDeliveryTarget, required: Slack destination snapshotted into a schedule and each admitted tick.
      - `app_id` string, nullable: Slack app id resolved when the destination was validated.
      - `channel_id` string, required: Slack channel id that receives completion notifications.
      - `installation_id` string, nullable: Workspace installation id resolved when the destination was validated.
      - `kind` 'slack_channel', required: Selects Slack channel delivery.
      - `team_id` string, required: Slack workspace id containing the destination channel.
    - `error_message` string, nullable, required: Sanitized terminal error message.
    - `live_url` string, nullable, required: Relative progress-stream path after executor admission.
    - `play_id` string, required: Play executed by this occurrence.
    - `revision_id` string, nullable, required: Immutable Play revision pinned for this tick.
    - `run_id` string, nullable, required: Durable Play run id after executor admission.
    - `schedule_id` string, required: Schedule that admitted this occurrence.
    - `scheduled_for` string, required: ISO 8601 logical occurrence time.
    - `started_at` string, nullable, required: ISO 8601 execution start time.
    - `status` 'queued' | 'running' | 'blocked' | 'completed' | 'failed' | 'skipped' | 'rejected', required: Current durable tick state.
    - `terminal_summary` object, nullable, required: Revision-defined public terminal result after private executor fields are removed.
    - `tick_id` string, required: Stable occurrence id.
    - `trigger_type` 'scheduled' | 'manual_run' | 'verification_preview' | 'event', required: Admission source: clock, run-now, verification preview, or provider event.
    - `triggered_by` WorkflowPlayTickTriggerEvidence, required: Known tick-admission evidence with support for historical and future fields.
      - `actor_id` string, nullable: Authenticated actor id for an operator-requested tick.
      - `actor_kind` string, nullable: Authenticated actor kind for an operator-requested tick.
      - `actor_label` string, nullable: Sanitized actor label captured at admission.
      - `admission_id` string, nullable: Durable provider-event admission id.
      - `auth_method` string, nullable: Authentication method used to request the tick.
      - `caller_agent_run_id` string, nullable: Calling agent run id when another agent requested the tick.
      - `caller_source` object, nullable: Sanitized caller provenance recorded for an agent-run request.
      - `kind` 'event', nullable: Marks a tick admitted from a provider event.
      - `origin` 'workflow_play_revision_verification', nullable: Marks a tick created by revision verification.
      - `source_actor_kind` string, nullable: Original actor kind delegated through a calling agent run.
      - `source_auth_method` string, nullable: Original authentication method delegated through a calling agent run.
      - `target_schedule_id` string, nullable: Schedule whose definition the preview tick verified.
      - `trigger_binding` WorkflowPlayTickTriggerBinding: Source binding that authorized a provider event tick.
        - `binding_id` string, nullable: Stable provider-event binding id.
        - `config_digest` string, nullable: Digest of the binding configuration used for admission.
      - `trigger_envelope` WorkflowPlayTickTriggerEnvelope: Provider event envelope copied into an admitted schedule tick.
        - `dedupe_key` string, nullable: Source-scoped idempotency key for the provider event.
        - `external_identity` string, nullable: Producer-owned event identity.
        - `occurred_at` string, nullable: ISO 8601 time when the provider event occurred.
        - `payload` object, nullable: Inline source-defined event payload when one was admitted.
        - `payload_artifact_digest` string, nullable: SHA-256 of the immutable event payload artifact when used.
        - `payload_digest` string, nullable: SHA-256 binding the inline or artifact-backed event payload.
        - `source` string, nullable: Stable provider or producer namespace.
        - `subject_refs` object[], nullable: Source-defined domain subjects attached to the event.
        - `version` '1', nullable: Trigger envelope contract version when recorded.
      - `verification_id` string, nullable: Verification request that created a preview tick.
    - `updated_at` string, required: ISO 8601 last tick mutation time.

## 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)