Go SDKFeature Clients

Schedules Client

Accessed via client.Schedules() on the Hatchet client.

SchedulesClient

SchedulesClient provides methods for interacting with workflow schedules

Methods:

NameDescription
CreateCreate creates a new scheduled workflow run.
DeleteDelete removes a scheduled workflow run.
GetGet retrieves a specific scheduled workflow run by its ID.
ListList retrieves a collection of scheduled workflow runs based on the provided parameters.

Functions

Create

Create creates a new scheduled workflow run.

func (s *SchedulesClient) Create(ctx context.Context, workflowName string, trigger CreateScheduledRunTrigger) (*rest.ScheduledWorkflows, error)

Parameters:

NameType
ctxcontext.Context
workflowNamestring
triggerCreateScheduledRunTrigger

Returns:

Type
*rest.ScheduledWorkflows
error

Delete

Delete removes a scheduled workflow run.

func (s *SchedulesClient) Delete(ctx context.Context, scheduledRunId string) error

Parameters:

NameType
ctxcontext.Context
scheduledRunIdstring

Returns:

Type
error

Get

Get retrieves a specific scheduled workflow run by its ID.

func (s *SchedulesClient) Get(ctx context.Context, scheduledRunId string) (*rest.ScheduledWorkflows, error)

Parameters:

NameType
ctxcontext.Context
scheduledRunIdstring

Returns:

Type
*rest.ScheduledWorkflows
error

List

List retrieves a collection of scheduled workflow runs based on the provided parameters.

func (s *SchedulesClient) List(ctx context.Context, opts rest.WorkflowScheduledListParams) (*rest.ScheduledWorkflowsList, error)

Parameters:

NameType
ctxcontext.Context
optsrest.WorkflowScheduledListParams

Returns:

Type
*rest.ScheduledWorkflowsList
error

CreateScheduledRunTrigger

CreateScheduledRunTrigger contains the configuration for creating a scheduled run trigger.

Fields:

NameTypeDescription
TriggerAttime.TimeTriggerAt specifies when the workflow should be triggered.
Inputmap[string]interface{}Input is the optional input data for the workflow.
AdditionalMetadatamap[string]interface{}AdditionalMetadata is optional metadata to associate with the scheduled run.
Priority*RunPriority

Last updated on August 24, 2026

On this page