---
title: "Create a schedule"
method: POST
path: "/api/scheduling"
tags: ["Schedule"]
---

# Create a schedule

`POST /api/scheduling`

## Request body

- SchedulingTransport
  - `permissions` string[]
  - `resourcePath` string
  - `actions` string[]
  - `groupedResourceTypeToActions` object
  - `id` string
  - `name` string, required
  - `notebookId` string, required
  - `executeFile` string, required
  - `notebookName` string
  - `lastNotebookExecutionId` string
  - `schedulingConfig` SchedulingConfig, required
    - `executionPattern` 'HOURLY' | 'X_HOURLY' | 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'CUSTOM'
    - `minute` integer
    - `everyXHours` integer
    - `time` string
    - `day` integer
    - `weekDays` integer[]
    - `monthPattern` 'SPECIFIC_DAY' | 'LAST_DAY'
    - `customCron` string
    - `timezoneId` string
    - `lastExecutionDate` string, date-time
    - `nextExecutionDate` string, date-time
    - `enabled` boolean
  - `timeout` integer, required
  - `timeUnit` 'MINUTES' | 'HOURS', required
  - `maxRetries` integer
  - `lastNotebookExecutionStatus` 'CREATED' | 'QUEUED' | 'STARTING' | 'STARTED' | 'COMPLETED' | 'NOTEBOOK_ERROR' | 'FAILED' | 'TIMEOUT' | 'CANCELED' | 'RESOURCES_ERROR' | 'CONFIGURATION_ERROR'
  - `notebookStopped` boolean
  - `objectId` string

## Response `201`

Created

## Other responses

- `204` — No Content
- `400` — Bad Request
- `403` — Forbidden
- `500` — Internal Server Error

---

[API](https://skmtc.dev/celonis/apis/celonis-machine-learning-workbench-apis.md) · [All operations](https://skmtc.dev/celonis/apis/celonis-machine-learning-workbench-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/celonis/celonis-machine-learning-workbench-apis/revisions/6f268387dd87/schema)