Docs
/
/

List schedules

Returns a paginated list of schedules for the current environment, filtered by workflow and optionally by recipients and tenant.

List schedules

Returns a paginated list of schedules for the current environment, filtered by workflow and optionally by recipients and tenant.

Endpoint

GET/v1/schedules

Rate limit

Tier 4

Query parameters

workflow
string

Filter by workflow key.

Filter by recipient references.

tenant
string

Filter by tenant ID.

after
string

The cursor to fetch entries after.

before
string

The cursor to fetch entries before.

page_size
integer

The number of items per page (defaults to 50).

Returns

ListSchedulesResponse

A response containing a list of schedules.

entries

A list of schedules.

__typename
string

The typename of the schema.

A map of properties describing a user or an object to identify in Knock and mark as who or what performed the action.

data
object(any)

An optional map of data to pass into the workflow execution. There is a 10MB limit on the size of the full data payload. Any individual string value greater than 1024 bytes in length will be truncated in your logs.

id
string(uuid)
Required

Unique identifier for the schedule.

inserted_at
string(date-time)
Required

Timestamp when the resource was created.

last_occurrence_at
string(date-time)

The last occurrence of the schedule.

next_occurrence_at
string(date-time)

The next occurrence of the schedule.

recipient
2 possible types
Required

A recipient of a notification, which is either a user or an object.

repeatsRequired

The repeat rule for the schedule.

__typename
string

The typename of the schema.

day_of_month
integer

The day of the month to repeat the schedule.

days
enum(string)[]

The days of the week to repeat the schedule.

montuewedthufrisatsun
frequency
enum(string)
Required

The frequency of the schedule.

dailyweeklymonthlyhourly
hours
integer

The hour of the day to repeat the schedule.

interval
integer

The interval of the schedule.

minutes
integer

The minute of the hour to repeat the schedule.

tenant
string

The tenant to trigger the workflow for. Triggering with a tenant will use any tenant-level overrides associated with the tenant object, and all messages produced from workflow runs will be tagged with the tenant.

updated_at
string(date-time)
Required

The timestamp when the resource was last updated.

workflow
string
Required

The workflow the schedule is applied to.

page_info

Pagination information for a list of resources.

__typename
string

The typename of the schema.

after
string

The cursor to fetch entries after.

before
string

The cursor to fetch entries before.

page_size
integer

The number of items per page (defaults to 50).

New chat