Sign in
Schedules

Delete schedules

Permanently deletes one or more schedules identified by the provided schedule IDs. This operation cannot be undone.

delete/v1/schedules

Request body

schedule_idsstring[] required

A list of schedule IDs.

Example request

{
  "schedule_ids": [
    "123e4567-e89b-12d3-a456-426614174000"
  ]
}

Response

OK

__typenamestring

The typename of the schema.

dataobject nullable

An optional map of data to pass into the workflow execution. There is a 1024 byte limit on the size of any single string value (with the exception of email attachments), and a 10MB limit on the size of the full data payload.

idstring uuid required

Unique identifier for the schedule.

inserted_atstring date-time required

Timestamp when the resource was created.

last_occurrence_atstring date-time nullable

The last occurrence of the schedule.

next_occurrence_atstring date-time nullable

The next occurrence of the schedule.

tenantstring nullable

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_atstring date-time required

The timestamp when the resource was last updated.

workflowstring required

The workflow the schedule is applied to.

Example response

[
  {
    "__typename": "Schedule",
    "actor": null,
    "data": null,
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "inserted_at": "2021-01-01T00:00:00Z",
    "last_occurrence_at": null,
    "next_occurrence_at": null,
    "recipient": {
      "__typename": "User",
      "avatar": null,
      "created_at": null,
      "email": "jane@ingen.net",
      "id": "jane",
      "name": "Jane Doe",
      "phone_number": null,
      "timezone": null,
      "updated_at": "2024-05-22T12:00:00Z"
    },
    "repeats": [
      {
        "__typename": "ScheduleRepeat",
        "day_of_month": null,
        "days": [
          "mon",
          "tue",
          "wed",
          "thu",
          "fri",
          "sat",
          "sun"
        ],
        "frequency": "daily",
        "hours": null,
        "interval": 1,
        "minutes": null
      }
    ],
    "tenant": null,
    "updated_at": "2021-01-01T00:00:00Z",
    "workflow": "workflow_123"
  }
]

Changes