List Scheduled Tasks

List an agent's recurring scheduled tasks.

get/v1/agents/{agent_id}/scheduled-tasks

Request

Base URL
https://api.xpander.ai (the document declares no server; this is the origin it was published from)
Auth
API key in header x-api-key

agent_idstring required

Successful Response

idstring required

Source-node id. Pass it to update/remove/run the task.

titlestring nullable

Human-readable label for the task.

cronstring required

Cron expression (5-field crontab, UTC), e.g. '0 9 * * *'.

promptstring required

Instruction the agent runs on each fire.

enabledboolean

Whether the task is active. Disabled tasks keep their config but do not fire.

type'scheduled-job' | 'live-surface'

What a scheduled task drives — a plain job vs a live-surface regeneration.

managedboolean

Managed by xpander. The platform owns cron/prompt/title; pause or resume it via enabled.

managed_kindstring nullable

Managed flavor - 'heartbeat' schedules derive from Autonomous mode and accept a user prompt addition.

user_promptstring nullable

The user's own addition to a heartbeat prompt; the platform appends its read-only part at run time.

llm_model_providerstring nullable

Run this task on a specific LLM provider instead of the agent's own (e.g. 'amazon_bedrock').

llm_model_namestring nullable

Run this task on a specific model id instead of the agent's own; pairs with llm_model_provider.

conversation_mode'same' | 'new'

Which conversation a schedule's fires run in.

conversation_idstring nullable

The conversation every fire continues, in same mode; empty in new mode.

owner_idstring nullable

Read-only: the member the task runs as.

No recorded changes to this operation across all 4 revisions of this API.