conecto. Get started
Schedules

Get a schedule

schedules_get · Reads only · Markdown

One schedule in full: its next three runs, its last ten runs with their call_ids and costs, and its rent.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

An example

Did the weekly journal export run on Monday? When's the next one?

Your agent callsschedules_getFree*

The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.

With these arguments
{
  "schedule_id": 4112
}
What comes back
{
  "schedule": {
    "schedule_id": 4112,
    "name": "Weekly journal for the accountant",
    "tool": "books_export",
    "arguments": {
      "what": "journal",
      "from": "{today-7}",
      "to": "{today-1}"
    },
    "timetable": {
      "every": "week",
      "days": [
        "mon"
      ],
      "at": "07:00"
    },
    "runs_when": "every Monday at 07:00",
    "time_zone": "America/Los_Angeles",
    "paused": false,
    "done": false,
    "bot": "Pip",
    "next_run_at": "2026-10-19T07:00:00-07:00",
    "last_run_at": "2026-10-12T07:00:00-07:00",
    "last_status": "succeeded",
    "last_call_id": "8c1e3a5c-7e9b-4d2f-a4c6-0e2a4c6e8a1b",
    "last_error": null,
    "runs": 2,
    "recent_runs": [
      {
        "call_id": "8c1e3a5c-7e9b-4d2f-a4c6-0e2a4c6e8a1b",
        "at": "2026-10-12T07:00:01-07:00",
        "status": "succeeded",
        "cost_usd": "$0.001",
        "error": null
      },
      {
        "call_id": "7b0d2f4b-6d8a-4c1e-93b5-fd1937d5f7a0",
        "at": "2026-10-05T07:00:01-07:00",
        "status": "succeeded",
        "cost_usd": "$0.001",
        "error": null
      }
    ],
    "rent": {
      "rental_id": 4101,
      "kind": "schedule",
      "label": "Schedule: Weekly journal for the accountant",
      "status": "active",
      "monthly_usd": "$0.50",
      "renews_at": "2026-10-30T14:00:00+00:00",
      "grace_until": null
    }
  },
  "upcoming": [
    "2026-10-19T07:00:00-07:00",
    "2026-10-26T07:00:00-07:00",
    "2026-11-02T07:00:00-08:00"
  ]
}

Use it when

To see whether a schedule ran and how each run went.

What it does

One schedule in full: its next three runs, its last ten runs (each a call_id for account_get_call, which has the result) and its rent.

What comes back

schedule: everything schedules_list shows, recent_runs (each with its call_id, time, status, cost and error) and rent; upcoming: the next runs. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
schedule_idRequiredintegerThe schedule_id schedules_create returned. At least 1.

The call

Over MCP, call schedules_get on https://api.conecto.chat/mcp/schedules. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/schedules_get \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"schedule_id":4112}'

When it refuses

A refused call costs nothing and says what to do next.

CodeWhenWhat to do
not_found404No schedule of the business has that schedule_id.Find it with schedules_list.

More Schedules tools

All 6 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md