---
title: "Trigger timer job"
method: POST
path: "/timer-jobs/{id}"
tags: ["Inspect"]
---

# Trigger timer job

`POST /timer-jobs/{id}`

## Request

- Base URL: `http://localhost:8090/inspect-api`
- URL: `http://localhost:8090/inspect-api/timer-jobs/{id}`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/flowable/apis/flowable-inspect-rest-api/docs/timer-jobs/:id/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `timerJobId` string, required

## Request body

- TriggerTimerRequest: Request that is used for triggering a timer
  - `createTestDefinition` boolean: Whether a test definition needs to be created for the trigger timer request. Only used when triggering a timer for a definition

## Response `200`

Indicates the timer job is found and triggered.

- TriggerResultDTO
  - `instanceId` string
  - `instanceType` string

---

[API](https://skmtc.dev/flowable/apis/flowable-inspect-rest-api.md) - [All operations](https://skmtc.dev/flowable/apis/flowable-inspect-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/flowable/apis/flowable-inspect-rest-api/revisions/5c72eb80b6c5?raw)