Schedule tasks

Schedule an agent to fire automatically on a cron expression: every Monday at 09:00, every hour, or any standard 5-field schedule.

Before you start

• A Ren account with a project that has at least one agent attached - The CLI installed, or a personal access token for the API and TypeScript calls

In the UI

In the UI

1. Open Triggers under your project in the sidebar.

2. Click New trigger and choose Cron.

3. Pick the agent to run, type the prompt it should receive each fire, and set the schedule (5-field cron).

4. Optionally set a timezone (defaults to UTC).

5. Click Create. The trigger is enabled immediately.

Programmatically

CLI API TypeScript

Select client CLIAPITypeScript

Create a cron trigger

ren cron-triggers create prj_abc123 \
  --project-agent-id pagt_abc123 \
  --input-message "Summarize this week's activity" \
  --schedule "0 9 * * MON" \
  --timezone "America/New_York"

List triggers in a project

ren cron-triggers list prj_abc123

Update a trigger (change schedule, prompt, or toggle enabled)

ren cron-triggers update prj_abc123 ctrg_abc123 \
  --schedule "0 */2 * * *" \
  --is-enabled false

Archive a trigger (stops the schedule permanently)

ren cron-triggers archive prj_abc123 ctrg_abc123

Create a cron trigger

curl -X POST https://api.useren.ai/api/projects/prj_abc123/cron-triggers \
  -H "Authorization: Bearer $REN_PAT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "projectAgentId": "pagt_abc123",
    "inputMessage": "Summarize this week'\''s activity",
    "schedule": "0 9 * * MON",
    "timezone": "America/New_York"
  }'

List triggers

curl "https://api.useren.ai/api/projects/prj_abc123/cron-triggers" \
  -H "Authorization: Bearer $REN_PAT_TOKEN"

Update a trigger

curl -X PATCH "https://api.useren.ai/api/projects/prj_abc123/cron-triggers/ctrg_abc123" \
  -H "Authorization: Bearer $REN_PAT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "schedule": "0 */2 * * *",
    "isEnabled": false
  }'

Archive a trigger

curl -X POST "https://api.useren.ai/api/projects/prj_abc123/cron-triggers/ctrg_abc123/archive" \
  -H "Authorization: Bearer $REN_PAT_TOKEN"

import { createRenClient, pat } from "@renai-labs/sdk"

const client = createRenClient({
baseUrl: "https://api.useren.ai",
auth: pat(process.env.REN_PAT_TOKEN!),
})

// Create a cron trigger
const { data: trigger, error } = await client.cronTrigger.create({
path: { projectId: "prj_abc123" },
body: {
projectAgentId: "pagt_abc123",
inputMessage: "Summarize this week's activity",
schedule: "0 9 \* \* MON",
timezone: "America/New_York",
},
})
if (error) throw error
console.log(trigger.id) // "ctrg_abc123"

// List triggers
await client.cronTrigger.list({ path: { projectId: "prj_abc123" } })

// Update a trigger
await client.cronTrigger.update({
path: { projectId: "prj_abc123", triggerId: trigger.id },
body: { schedule: "0 \*/2 \* \* \*", isEnabled: false },
})

// Archive a trigger
await client.cronTrigger.archive({
path: { projectId: "prj_abc123", triggerId: trigger.id },
})

The schedule uses standard 5-field cron syntax: minute hour day-of-month month day-of-week. Archiving a trigger stops it permanently.