Job zur Laufzeit anlegen

POST

/v1/jobs

curl --request POST \
  --url https://example.com/v1/jobs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "id": "daily-digest", "schedule": "0 7 * * *", "prompt": "Fasse die wichtigsten Ereignisse der letzten 24 Stunden zusammen.", "category": "summarize", "overlap": "skip", "enabled": true }'

• Adresse aus config.json → api.addr, Standard 127.0.0.1:2330

Zusätzlich zu den Jobs aus config.json. Läuft nur, solange der Daemon läuft — nicht in die config.json zurückgeschrieben.

Authorizations

• bearerAuth

Request Body^required

Media typeapplication/json

Wie Job, aber ohne source — das setzt der Server.

object

id

required

string

schedule

required

string

prompt

required

string

category

string

skill

string

timeout_sec

integer

overlap

string

Allowed values: skip allow

enabled

required

boolean

Example

{
  "id": "daily-digest",
  "schedule": "0 7 * * *",
  "prompt": "Fasse die wichtigsten Ereignisse der letzten 24 Stunden zusammen.",
  "category": "summarize",
  "overlap": "skip",
  "enabled": true
}

Responses

201

Angelegter Job (source ist jetzt "api").

Media typeapplication/json

object

id

string

schedule

Cron-Ausdruck

string

prompt

string

category

string

skill

string

timeout_sec

Default 300

integer

overlap

Default skip

string

Allowed values: skip allow

enabled

boolean

source

string

Allowed values: config api

Example

{
  "overlap": "skip",
  "source": "config"
}

400

Ungültiger Job (z. B. defekter Cron-Ausdruck, doppelte ID).

Media typeapplication/json

object

error

string

Example^generated

{
  "error": "example"
}

404

Scheduler abgeschaltet.

Media typeapplication/json

object

error

string

Example^generated

{
  "error": "example"
}