Scheduled Task erstellen

Create a scheduled task

curl --request POST \
  --url https://api.langdock.com/automations/v1 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "prompt": "<string>",
  "timeOfDay": "<string>",
  "dayOfWeek": 3,
  "dayOfMonth": 16,
  "daysOfWeek": [
    3
  ],
  "timezone": "<string>",
  "modelId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "assistantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "taggedAssistantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "taggedIntegrationIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "taggedKnowledgeFolderIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "taggedWorkflowIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "taggedSkillSlugs": [
    "<string>"
  ],
  "attachmentIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ]
}
'

import requests

url = "https://api.langdock.com/automations/v1"

payload = {
    "name": "<string>",
    "prompt": "<string>",
    "timeOfDay": "<string>",
    "dayOfWeek": 3,
    "dayOfMonth": 16,
    "daysOfWeek": [3],
    "timezone": "<string>",
    "modelId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "assistantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "taggedAssistantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "taggedIntegrationIds": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
    "taggedKnowledgeFolderIds": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
    "taggedWorkflowIds": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
    "taggedSkillSlugs": ["<string>"],
    "attachmentIds": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    prompt: '<string>',
    timeOfDay: '<string>',
    dayOfWeek: 3,
    dayOfMonth: 16,
    daysOfWeek: [3],
    timezone: '<string>',
    modelId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    assistantId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    taggedAssistantId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    taggedIntegrationIds: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
    taggedKnowledgeFolderIds: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
    taggedWorkflowIds: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
    taggedSkillSlugs: ['<string>'],
    attachmentIds: ['3c90c3cc-0d44-4b50-8888-8dd25736052a']
  })
};

fetch('https://api.langdock.com/automations/v1', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.langdock.com/automations/v1",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'prompt' => '<string>',
    'timeOfDay' => '<string>',
    'dayOfWeek' => 3,
    'dayOfMonth' => 16,
    'daysOfWeek' => [
        3
    ],
    'timezone' => '<string>',
    'modelId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'assistantId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'taggedAssistantId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'taggedIntegrationIds' => [
        '3c90c3cc-0d44-4b50-8888-8dd25736052a'
    ],
    'taggedKnowledgeFolderIds' => [
        '3c90c3cc-0d44-4b50-8888-8dd25736052a'
    ],
    'taggedWorkflowIds' => [
        '3c90c3cc-0d44-4b50-8888-8dd25736052a'
    ],
    'taggedSkillSlugs' => [
        '<string>'
    ],
    'attachmentIds' => [
        '3c90c3cc-0d44-4b50-8888-8dd25736052a'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.langdock.com/automations/v1"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"timeOfDay\": \"<string>\",\n  \"dayOfWeek\": 3,\n  \"dayOfMonth\": 16,\n  \"daysOfWeek\": [\n    3\n  ],\n  \"timezone\": \"<string>\",\n  \"modelId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"assistantId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"taggedAssistantId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"taggedIntegrationIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"taggedKnowledgeFolderIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"taggedWorkflowIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"taggedSkillSlugs\": [\n    \"<string>\"\n  ],\n  \"attachmentIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.langdock.com/automations/v1")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"timeOfDay\": \"<string>\",\n  \"dayOfWeek\": 3,\n  \"dayOfMonth\": 16,\n  \"daysOfWeek\": [\n    3\n  ],\n  \"timezone\": \"<string>\",\n  \"modelId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"assistantId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"taggedAssistantId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"taggedIntegrationIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"taggedKnowledgeFolderIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"taggedWorkflowIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"taggedSkillSlugs\": [\n    \"<string>\"\n  ],\n  \"attachmentIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.langdock.com/automations/v1")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"timeOfDay\": \"<string>\",\n  \"dayOfWeek\": 3,\n  \"dayOfMonth\": 16,\n  \"daysOfWeek\": [\n    3\n  ],\n  \"timezone\": \"<string>\",\n  \"modelId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"assistantId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"taggedAssistantId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"taggedIntegrationIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"taggedKnowledgeFolderIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"taggedWorkflowIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"taggedSkillSlugs\": [\n    \"<string>\"\n  ],\n  \"attachmentIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ]\n}"

response = http.request(request)
puts response.read_body

POST

automations

Create a scheduled task

curl --request POST \
  --url https://api.langdock.com/automations/v1 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "prompt": "<string>",
  "timeOfDay": "<string>",
  "dayOfWeek": 3,
  "dayOfMonth": 16,
  "daysOfWeek": [
    3
  ],
  "timezone": "<string>",
  "modelId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "assistantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "taggedAssistantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "taggedIntegrationIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "taggedKnowledgeFolderIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "taggedWorkflowIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "taggedSkillSlugs": [
    "<string>"
  ],
  "attachmentIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ]
}
'

import requests

url = "https://api.langdock.com/automations/v1"

payload = {
    "name": "<string>",
    "prompt": "<string>",
    "timeOfDay": "<string>",
    "dayOfWeek": 3,
    "dayOfMonth": 16,
    "daysOfWeek": [3],
    "timezone": "<string>",
    "modelId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "assistantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "taggedAssistantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "taggedIntegrationIds": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
    "taggedKnowledgeFolderIds": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
    "taggedWorkflowIds": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
    "taggedSkillSlugs": ["<string>"],
    "attachmentIds": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    prompt: '<string>',
    timeOfDay: '<string>',
    dayOfWeek: 3,
    dayOfMonth: 16,
    daysOfWeek: [3],
    timezone: '<string>',
    modelId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    assistantId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    taggedAssistantId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    taggedIntegrationIds: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
    taggedKnowledgeFolderIds: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
    taggedWorkflowIds: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
    taggedSkillSlugs: ['<string>'],
    attachmentIds: ['3c90c3cc-0d44-4b50-8888-8dd25736052a']
  })
};

fetch('https://api.langdock.com/automations/v1', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.langdock.com/automations/v1",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'prompt' => '<string>',
    'timeOfDay' => '<string>',
    'dayOfWeek' => 3,
    'dayOfMonth' => 16,
    'daysOfWeek' => [
        3
    ],
    'timezone' => '<string>',
    'modelId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'assistantId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'taggedAssistantId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'taggedIntegrationIds' => [
        '3c90c3cc-0d44-4b50-8888-8dd25736052a'
    ],
    'taggedKnowledgeFolderIds' => [
        '3c90c3cc-0d44-4b50-8888-8dd25736052a'
    ],
    'taggedWorkflowIds' => [
        '3c90c3cc-0d44-4b50-8888-8dd25736052a'
    ],
    'taggedSkillSlugs' => [
        '<string>'
    ],
    'attachmentIds' => [
        '3c90c3cc-0d44-4b50-8888-8dd25736052a'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.langdock.com/automations/v1"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"timeOfDay\": \"<string>\",\n  \"dayOfWeek\": 3,\n  \"dayOfMonth\": 16,\n  \"daysOfWeek\": [\n    3\n  ],\n  \"timezone\": \"<string>\",\n  \"modelId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"assistantId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"taggedAssistantId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"taggedIntegrationIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"taggedKnowledgeFolderIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"taggedWorkflowIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"taggedSkillSlugs\": [\n    \"<string>\"\n  ],\n  \"attachmentIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.langdock.com/automations/v1")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"timeOfDay\": \"<string>\",\n  \"dayOfWeek\": 3,\n  \"dayOfMonth\": 16,\n  \"daysOfWeek\": [\n    3\n  ],\n  \"timezone\": \"<string>\",\n  \"modelId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"assistantId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"taggedAssistantId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"taggedIntegrationIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"taggedKnowledgeFolderIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"taggedWorkflowIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"taggedSkillSlugs\": [\n    \"<string>\"\n  ],\n  \"attachmentIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.langdock.com/automations/v1")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"timeOfDay\": \"<string>\",\n  \"dayOfWeek\": 3,\n  \"dayOfMonth\": 16,\n  \"daysOfWeek\": [\n    3\n  ],\n  \"timezone\": \"<string>\",\n  \"modelId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"assistantId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"taggedAssistantId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"taggedIntegrationIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"taggedKnowledgeFolderIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"taggedWorkflowIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"taggedSkillSlugs\": [\n    \"<string>\"\n  ],\n  \"attachmentIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ]\n}"

response = http.request(request)
puts response.read_body

Erstellt eine Scheduled Task, die diesem Workspace-API-Key gehört. Neue Aufgaben starten mit active auf true. Der Status der Antwort ist 201. Der Body enthält kein runCount.

Basis-URL

https://api.langdock.com/automations/v1

Dedicated DeploymentsErsetze api.langdock.com durch <your-deployment-url>/api/public in allen Anfragen.

Benötigte Scopes

Dieser Endpoint braucht den Scope AUTOMATION_API (Scheduled Tasks API) auf einem Workspace-API-Key. Ein Workspace kann 10 Aufgaben für diesen Besitzer halten. Die nächste Erstellung liefert 400 mit der Message AUTOMATION_LIMIT_REACHED. Eine abgelaufene Trial liefert 403 mit dem Code TRIAL_EXPIRED.

Parameter

Sende einen JSON-Body. Unbekannte Felder werden abgelehnt. Die Zeitplanregeln stehen in der Scheduled Tasks API Übersicht.

Parameter	Typ	Pflicht	Beschreibung
`name`	string	Ja	1 bis 200 Zeichen.
`prompt`	string	Ja	1 bis 120000 Zeichen.
`frequency`	string	Ja	`MANUAL`, `DAILY`, `WEEKDAYS`, `WEEKLY`, `MONTHLY` oder `SELECTED_WEEKDAYS`.
`timeOfDay`	string	Für jede Frequenz außer `MANUAL`	`HH:mm` im 24-Stunden-Format.
`dayOfWeek`	integer	Für `WEEKLY`	0 (Sonntag) bis 6 (Samstag).
`dayOfMonth`	integer	Für `MONTHLY`	1 bis 31.
`daysOfWeek`	integer[]	Für `SELECTED_WEEKDAYS`	Mindestens ein Tag, jeder von 0 bis 6. Höchstens 7 Werte.
`timezone`	string \| null	Nein	IANA-Name, höchstens 64 Zeichen. Leer oder weggelassen wird bei einer geplanten Frequenz als `UTC` gespeichert.
`modelMode`	string	Nein	`UNSET`, `EXPLICIT` oder `AUTO`.
`modelId`	string \| null	Wenn `modelMode` `EXPLICIT` ist	Modell-UUID. Muss in derselben Anfrage stehen.
`assistantId`	string \| null	Nein	UUID des primären Agenten. Muss für den Key verfügbar sein.
`taggedAssistantId`	string \| null	Nein	Zusätzliche Agentenerwähnung. Wird verworfen, wenn der Key sie nicht nutzen kann.
`taggedIntegrationIds`	string[]	Nein	Höchstens 20. Nicht erreichbare IDs werden verworfen.
`taggedKnowledgeFolderIds`	string[]	Nein	Höchstens 20. Nicht erreichbare IDs werden verworfen.
`taggedWorkflowIds`	string[]	Nein	Höchstens 20. Nicht erreichbare IDs werden verworfen.
`taggedSkillSlugs`	string[]	Nein	Höchstens 20. Jeder Slug hat höchstens 100 Zeichen. Nicht erreichbare Slugs werden verworfen.
`attachmentIds`	string[]	Nein	Höchstens 20 Anhang-UUIDs, die diesem Key im Workspace schon gehören.

Beispiel

const axios = require("axios");

async function createScheduledTask() {
  const response = await axios.post(
    "https://api.langdock.com/automations/v1",
    {
      name: "Monday pipeline brief",
      prompt: "Summarize overnight pipeline changes for the revenue team.",
      frequency: "WEEKLY",
      timeOfDay: "09:00",
      dayOfWeek: 1,
      timezone: "Europe/Berlin"
    },
    {
      headers: {
        Authorization: "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
      }
    }
  );

  console.log(response.status, response.data.automation.id);
}

createScheduledTask();

Antwortformat

Erfolgreiche Antwort (201 Created)

automation entspricht dem Scheduled-Task-Objekt ohne runCount.

{
  automation: {
    id: string;
    createdAt: string;
    name: string;
    prompt: string;
    modelId: string | null;
    modelMode: "UNSET" | "EXPLICIT" | "AUTO";
    assistantId: string | null;
    taggedAssistantId: string | null;
    frequency:
      | "MANUAL"
      | "DAILY"
      | "WEEKDAYS"
      | "WEEKLY"
      | "MONTHLY"
      | "SELECTED_WEEKDAYS";
    timeOfDay: string | null;
    dayOfWeek: number | null;
    dayOfMonth: number | null;
    daysOfWeek: number[];
    timezone: string | null;
    active: boolean;
    lastRunAt: string | null;
    attachments: Array<{
      id: string;
      name: string;
      mimeType: string | null;
      type: string | null;
    }>;
    taggedIntegrationIds: string[];
    taggedKnowledgeFolderIds: string[];
    taggedWorkflowIds: string[];
    taggedSkillSlugs: string[];
  };
}

Fehlerbehandlung

Statuscode	Beschreibung
400	Ungültiger Body oder Message `AUTOMATION_LIMIT_REACHED`
401	Ungültiger oder fehlender API-Key, oder der Key-User wurde nicht gefunden
403	`AUTOMATION_API` fehlt, persönlicher API-Key, Scheduled Tasks deaktiviert, kein Produktzugriff, `TRIAL_EXPIRED` oder `AUTOMATION_TAG_ACCESS_DENIED`
405	Methode nicht erlaubt
429	Rate Limit überschritten
500	Interner Serverfehler

Ein ungültiger Body liefert 400 mit der Message Invalid request und einem errors-Array. Fehlende Uhrzeitfelder nutzen timeOfDay is required for scheduled automations, dayOfWeek is required for weekly automations, dayOfMonth is required for monthly automations oder daysOfWeek is required for selected weekday automations. Eine ungültige Zeitzone nutzt timezone must be a valid IANA identifier. modelMode EXPLICIT ohne modelId nutzt modelId is required for explicit model selection. Eine abgelaufene Trial liefert 403 mit dem Code TRIAL_EXPIRED und der Message Your trial has expired. Upgrade to continue.

Langdock blockiert Anfragen aus Browser-Origins absichtlich, um deinen API-Key zu schützen und deine Anwendungen sicher zu halten. Mehr dazu findest du im Guide zu API Key Best Practices.

Autorisierungen

Authorization

string

header

erforderlich

API key as Bearer token. Format "Bearer YOUR_API_KEY"

Body

application/json

name

string

erforderlich

Required string length: 1 - 200

prompt

string

erforderlich

Required string length: 1 - 120000

frequency

enum<string>

erforderlich

Verfügbare Optionen:

MANUAL,

DAILY,

WEEKDAYS,

WEEKLY,

MONTHLY,

SELECTED_WEEKDAYS

timeOfDay

string | null

24 hour HH:mm. Required unless frequency is MANUAL.

dayOfWeek

integer | null

Required for WEEKLY. 0 is Sunday and 6 is Saturday.

Erforderlicher Bereich: 0 <= x <= 6

dayOfMonth

integer | null

Required for MONTHLY.

Erforderlicher Bereich: 1 <= x <= 31

daysOfWeek

integer[]

Required for SELECTED_WEEKDAYS.

Maximum array length: 7

Erforderlicher Bereich: 0 <= x <= 6

timezone

string | null

IANA timezone. Empty or omitted on a scheduled frequency is stored as UTC.

Maximum string length: 64

modelMode

enum<string>

Verfügbare Optionen:

UNSET,

EXPLICIT,

AUTO

modelId

string<uuid> | null

Required in the same request when modelMode is EXPLICIT.

assistantId

string<uuid> | null

taggedAssistantId

string<uuid> | null

taggedIntegrationIds

string<uuid>[]

Maximum array length: 20

taggedKnowledgeFolderIds

string<uuid>[]

Maximum array length: 20

taggedWorkflowIds

string<uuid>[]

Maximum array length: 20

taggedSkillSlugs

string[]

Maximum array length: 20

Maximum string length: 100

attachmentIds

string<uuid>[]

Maximum array length: 20

Antwort

Scheduled task created. The automation object does not include runCount.

Überblick

Completion API

Embedding API

Agents API

Integrations API

Skills API

Knowledge Folder API

Prompt Library API

Usage Export API

Workflow API

Scheduled Tasks API

User Management API

Audit Logs API

Scheduled Task erstellen

Basis-URL

Benötigte Scopes

Parameter

Beispiel

Antwortformat

Erfolgreiche Antwort (201 Created)

Fehlerbehandlung

Autorisierungen

Body

Antwort

​Basis-URL

​Benötigte Scopes

​Parameter

​Beispiel

​Antwortformat

​Erfolgreiche Antwort (201 Created)

​Fehlerbehandlung

Autorisierungen

Body

Antwort

Basis-URL

Benötigte Scopes

Parameter

Beispiel

Antwortformat

Erfolgreiche Antwort (201 Created)

Fehlerbehandlung