Schedules
List schedules
List your organization’s schedules, newest first.
GET
/
api
/
v2
/
schedules
from hai_agents import Client
client = Client()
page = client.schedules.list_schedules()
for schedule in page.items:
print(schedule.id, schedule.name, schedule.paused)
import { HaiAgentsClient } from "hai-agents";
const client = new HaiAgentsClient();
const page = await client.schedules.listSchedules();
for (const schedule of page.items) {
console.log(schedule.id, schedule.name, schedule.paused);
}
curl "https://agp.eu.hcompany.ai/api/v2/schedules" \
-H "Authorization: Bearer $HAI_API_KEY"
{
"items": [
{
"id": "9f8e7d6c-5b4a-4c3d-8e2f-1a0b9c8d7e6f",
"name": "morning-market-scan",
"description": "Weekday scan of new Paris listings",
"timing": {"type": "cron", "expression": "0 9 * * 1-5", "timezone": "Europe/Paris"},
"session_request": {
"agent": "h/web-surfer-flash",
"messages": [
{"type": "user_message", "message": "Scan new apartment listings in Paris 11e and summarize the top five"}
],
"max_time_s": 3600
},
"paused": false,
"pause_note": null,
"repeats": null,
"sessions_created": 10,
"next_run_times": [
"2026-07-06T07:00:00Z",
"2026-07-07T07:00:00Z",
"2026-07-08T07:00:00Z",
"2026-07-09T07:00:00Z",
"2026-07-10T07:00:00Z"
],
"last_run_at": "2026-07-03T07:00:00Z",
"created_at": "2026-06-20T12:00:00Z",
"updated_at": "2026-07-03T07:00:00Z"
}
],
"page": 1,
"total": 1
}
Query parameters
integer
default:"1"
Page number (1-based).
integer
default:"10"
Items per page. Maximum:
1000.string
default:"-created_at"
Sort order. Options:
created_at, -created_at.Response
200 with a page envelope of schedule objects.
from hai_agents import Client
client = Client()
page = client.schedules.list_schedules()
for schedule in page.items:
print(schedule.id, schedule.name, schedule.paused)
import { HaiAgentsClient } from "hai-agents";
const client = new HaiAgentsClient();
const page = await client.schedules.listSchedules();
for (const schedule of page.items) {
console.log(schedule.id, schedule.name, schedule.paused);
}
curl "https://agp.eu.hcompany.ai/api/v2/schedules" \
-H "Authorization: Bearer $HAI_API_KEY"
{
"items": [
{
"id": "9f8e7d6c-5b4a-4c3d-8e2f-1a0b9c8d7e6f",
"name": "morning-market-scan",
"description": "Weekday scan of new Paris listings",
"timing": {"type": "cron", "expression": "0 9 * * 1-5", "timezone": "Europe/Paris"},
"session_request": {
"agent": "h/web-surfer-flash",
"messages": [
{"type": "user_message", "message": "Scan new apartment listings in Paris 11e and summarize the top five"}
],
"max_time_s": 3600
},
"paused": false,
"pause_note": null,
"repeats": null,
"sessions_created": 10,
"next_run_times": [
"2026-07-06T07:00:00Z",
"2026-07-07T07:00:00Z",
"2026-07-08T07:00:00Z",
"2026-07-09T07:00:00Z",
"2026-07-10T07:00:00Z"
],
"last_run_at": "2026-07-03T07:00:00Z",
"created_at": "2026-06-20T12:00:00Z",
"updated_at": "2026-07-03T07:00:00Z"
}
],
"page": 1,
"total": 1
}
Was this page helpful?
⌘I
from hai_agents import Client
client = Client()
page = client.schedules.list_schedules()
for schedule in page.items:
print(schedule.id, schedule.name, schedule.paused)
import { HaiAgentsClient } from "hai-agents";
const client = new HaiAgentsClient();
const page = await client.schedules.listSchedules();
for (const schedule of page.items) {
console.log(schedule.id, schedule.name, schedule.paused);
}
curl "https://agp.eu.hcompany.ai/api/v2/schedules" \
-H "Authorization: Bearer $HAI_API_KEY"
{
"items": [
{
"id": "9f8e7d6c-5b4a-4c3d-8e2f-1a0b9c8d7e6f",
"name": "morning-market-scan",
"description": "Weekday scan of new Paris listings",
"timing": {"type": "cron", "expression": "0 9 * * 1-5", "timezone": "Europe/Paris"},
"session_request": {
"agent": "h/web-surfer-flash",
"messages": [
{"type": "user_message", "message": "Scan new apartment listings in Paris 11e and summarize the top five"}
],
"max_time_s": 3600
},
"paused": false,
"pause_note": null,
"repeats": null,
"sessions_created": 10,
"next_run_times": [
"2026-07-06T07:00:00Z",
"2026-07-07T07:00:00Z",
"2026-07-08T07:00:00Z",
"2026-07-09T07:00:00Z",
"2026-07-10T07:00:00Z"
],
"last_run_at": "2026-07-03T07:00:00Z",
"created_at": "2026-06-20T12:00:00Z",
"updated_at": "2026-07-03T07:00:00Z"
}
],
"page": 1,
"total": 1
}