Scheduled Tasks - Telnyx

this.queue(), this.schedule(), and this.every() let you defer work durably. Tasks survive pod restarts — the scheduler uses the actor’s built-in alarm mechanism. A task’s name must match a method on your class.

// Run immediately (next alarm tick)
await this.queue("process");

// Run after a delay (in seconds)
await this.schedule(3600, "sendReminder");

// Run repeatedly (interval in seconds)
await this.every(300, "checkStatus");

// With a stable id — re-scheduling replaces the prior task (dedup)
await this.schedule(86_400, "nudge", null, { id: "daily-nudge" });

// Cancel a named task
await this.cancelSchedule("daily-nudge");

// List pending tasks
const tasks = await this.listSchedules();

Task dispatch

When a task fires, the platform calls the method by name on your actor instance:

export class MyAgent extends Agent {
  async sendReminder(): Promise<void> {
    // runs when the scheduled timer fires
  }

  // Fallback for tasks whose method name doesn't exist on the class
  protected override async onTask(name: string, payload: unknown): Promise<void> {
    console.error(`Unknown task: ${name}`);
  }
}

Retries

Tasks retry up to 5 times by default on failure. Configure with maxRetries:

await this.queue("process", data, { maxRetries: 3 });

⌘I