Base URL
API key scopes
Every endpoint uses one scope.
Create the key under Settings > Workspace > Products > API. Personal API keys cannot call this API, even if the scope appears on the key.
The key must belong to a service account. Scheduled Tasks must be enabled for the workspace, and that service account must have access. General access covers the account. Member access covers it only when the account or one of its groups is included.
Each task is owned by the service account that created it. The key can only see and change its own tasks. A workspace can hold 10 tasks per owner. The 11th create returns
400 with AUTOMATION_LIMIT_REACHED.
If that service account no longer has a live key with AUTOMATION_API, active tasks that are not MANUAL are paused. A remaining key, including one you created while rotating, keeps those tasks running. MANUAL tasks have no clock, so this pause does not change them.
Available endpoints
Scheduled task object
List and get includerunCount. Create, update, pause, and resume return the same object without runCount.
updatedAt field.
Schedule
timeOfDay uses 24 hour HH:mm. A missing or invalid clock for a scheduled frequency returns 400.
Context on the task
assistantId is the primary agent. It must be available to the key, or create and update return 403 with AUTOMATION_TAG_ACCESS_DENIED:assistant:{id}.
modelMode EXPLICIT requires modelId in the same request. The model must be selectable for that service account. Otherwise the response is 403 with AUTOMATION_TAG_ACCESS_DENIED:model:missing or AUTOMATION_TAG_ACCESS_DENIED:model:{id}. AUTO and UNSET store modelId as null. If you omit modelMode and send modelId, the task is stored as EXPLICIT. If you omit both, it is stored as UNSET.
Tagged integrations, folders, workflows, skills, and taggedAssistantId that the key cannot use are dropped on save. They do not fail the request. attachmentIds must already belong to the key’s service account in this workspace. An attachment it does not own returns 403 with AUTOMATION_TAG_ACCESS_DENIED:attachment:unknown.
Each tag array accepts at most 20 values. Each skill slug is at most 100 characters. attachmentIds accepts at most 20 ids.
Rate limits
The Scheduled Tasks API follows standard API rate limits. If you exceed the limit, you receive a429 response. Wait and retry with exponential backoff.
Langdock intentionally blocks browser-origin requests to protect your API key and ensure your applications remain secure. For more information, please see our guide on API Key Best Practices.