---
title: "Trigger an execution"
method: POST
path: "/api/executions"
tags: ["Notebook Execution"]
---

# Trigger an execution

`POST /api/executions`

## Request body

- NotebookExecutionTransport
  - `id` string
  - `notebookId` string, required
  - `notebookExecutionSourceId` string
  - `notebookExecutionSource` string
  - `executionFileName` string, required
  - `notebookExecutionStatus` 'CREATED' | 'QUEUED' | 'STARTING' | 'STARTED' | 'COMPLETED' | 'NOTEBOOK_ERROR' | 'FAILED' | 'TIMEOUT' | 'CANCELED' | 'RESOURCES_ERROR' | 'CONFIGURATION_ERROR'
  - `started` string, date-time
  - `completed` string, date-time
  - `params` unknown
  - `result` string
  - `logsOutputPath` string
  - `executionTimeout` integer
  - `maxRetries` integer
  - `timeUnit` 'NANOSECONDS' | 'MICROSECONDS' | 'MILLISECONDS' | 'SECONDS' | 'MINUTES' | 'HOURS' | 'DAYS'

## Response `200`

OK

## 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)