Skip to main content
POST
Add a scheduled task

Authorizations

X-API-Key
string
header
required

A compute API key (x402c_...). Mint one in the dashboard under Settings -> API Keys. This is the ONLY auth /pods/v1/* accepts - wallet signatures are bound to method+path+body and do not survive the internal hop, so signature callers must use the dashboard routes instead. Two extra scopes gate the dangerous powers: pods:wallet:write (pod wallet money, backup passphrase) and pods:control:write (connectors, full-power control socket).

Path Parameters

id
string<uuid>
required

Pod id, as returned by create/list.

Body

application/json
kind
enum<string>
required
Available options:
cron,
every,
at
schedule
string
required

The schedule expression, interpreted per kind.

Example:

"0 9 * * *"

name
string
default:Task
message
string

What to say to the agent when the task fires.

session
enum<string>
default:isolated

isolated runs the task in its own session. main runs it in the pod's shared conversation.

Available options:
isolated,
main

Response

Queued for the pod.

accepted
boolean
note
string