AI Agent Cron Runs

Create AI agent cron run

Records a single scheduled execution of an AI agent, with its status, duration, and a preview of the response. The cron runner uses this internally — you typically only read these entries.

post/v1/ai-agents/{agent_id}/cron-runs

Request

  • Base URL: https://api.withone.ai
  • URL: https://api.withone.ai/v1/ai-agents/{agent_id}/cron-runs
  • Auth: API key in header X-One-Secret

Path parameters

agent_idstring uuid required

AI agent ID

Request body

completedAtstring date-time nullable
durationMsinteger nullable
errorstring nullable
responsePreviewstring nullable
scheduledAtstring date-time required
startedAtstring date-time required
status'pending' | 'running' | 'completed' | 'failed' required

Response

Created cron run

agentIdstring uuid required
completedAtstring date-time nullable
createdAtstring date-time required
durationMsinteger nullable
errorstring nullable
idstring uuid required
responsePreviewstring nullable
scheduledAtstring date-time required
startedAtstring date-time nullable
status'pending' | 'running' | 'completed' | 'failed' required

Changes

No recorded changes to this operation across all 1 revision of this API.