---
title: "Trigger Schedule"
method: POST
path: "/agents/{agent_id}/schedules/{schedule_name}/trigger"
tags: ["Schedules"]
---

# Trigger Schedule

`POST /agents/{agent_id}/schedules/{schedule_name}/trigger`

Trigger a schedule to run immediately, regardless of its regular schedule.

## Path parameters

- `schedule_name` string, required
- `agent_id` string, required

## Response `200`

Successful Response

- ScheduleResponse — Response model for schedule operations
  - `action` ScheduleActionInfo, required — Information about the scheduled action
    - `task_queue` string, required — Task queue for the workflow
    - `workflow_id_prefix` string, required — Prefix for workflow execution IDs
    - `workflow_name` string, required — Name of the workflow being executed
    - `workflow_params` unknown[], nullable — Parameters passed to the workflow
      - unknown
  - `agent_id` string, required — ID of the agent this schedule belongs to
  - `created_at` string, date-time, nullable — When the schedule was created
  - `last_action_time` string, date-time, nullable — When the schedule last executed
  - `name` string, required — Human-readable name for the schedule
  - `next_action_times` string[] — Upcoming scheduled execution times
  - `num_actions_missed` integer — Number of scheduled executions that were missed
  - `num_actions_taken` integer — Number of times the schedule has executed
  - `schedule_id` string, required — Unique identifier for the schedule
  - `spec` ScheduleSpecInfo, required — Information about the schedule specification
    - `cron_expressions` string[] — Cron expressions for the schedule
    - `end_at` string, date-time, nullable — When the schedule stops being active
    - `intervals_seconds` integer[] — Interval specifications in seconds
    - `start_at` string, date-time, nullable — When the schedule starts being active
  - `state` 'ACTIVE' | 'PAUSED', required — Schedule state enum

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/terminaluse/apis/sb0-api.md) · [All operations](https://skmtc.net/terminaluse/apis/sb0-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/terminaluse/sb0-api/versions/f24a474dc415/schema)