---
title: "Add a scheduled run"
method: POST
path: "/client/services/{id}/jobs"
tags: ["Apps"]
---

# Add a scheduled run

`POST /client/services/{id}/jobs`

## Request

- Base URL: `https://api.roar-ai.com`
- URL: `https://api.roar-ai.com/client/services/{id}/jobs`
- Auth: HTTP bearer

A path on your app and a schedule to call it on. `id` is a SERVICE id — take it from `services[].id` on `GET /client/apps/{appId}`, not the app id itself. Requires `apps:deploy`.

We wait 30 seconds for your app to answer; set `timeoutSeconds` (5 to 300; at most 110 for an app not hosted on our servers — the jobs list returns the app's own `maxTimeoutSeconds`) for a job that genuinely takes longer. Past that, answer at once and finish the work in the background.

## Path parameters

- `id` string, uuid, required

## Response `200`

The created job

## Other responses

- `403`: Key lacks apps:deploy
- `404`: No such app service

---

[API](https://skmtc.dev/roar-ai/apis/roar-ai-api.md) · [All operations](https://skmtc.dev/roar-ai/apis/roar-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/roar-ai/apis/roar-ai-api/revisions/37e4d0d5a7fe?raw)