---
title: "Get schema refresh schedule"
method: GET
path: "/api/v1/connections/{connectionId}/schedules/{scheduleId}"
tags: ["Connections"]
---

# Get schema refresh schedule

`GET /api/v1/connections/{connectionId}/schedules/{scheduleId}`

## Path parameters

- `connectionId` string, uuid, required — Connection ID
- `scheduleId` string, uuid, required — Schedule ID

## Response `200`

Schema refresh schedule details

- object — Get schedule response
  - `connectionId` string, uuid, required — Connection ID this schedule belongs to
  - `createdAt` string, required — Schedule creation timestamp (ISO 8601)
  - `description` string, required — Human-readable schedule description
  - `disabledAt` string, nullable, required — Timestamp when schedule was disabled (ISO 8601)
  - `hardRefresh` boolean, required — When true, the scheduled refresh performs a hard refresh that fully discards and rebuilds the schema model. When false, it performs a soft refresh that merges newly generated views with the existing model.
  - `schedule` string, required — AWS EventBridge cron expression (6 fields: minute hour day-of-month month day-of-week year). See https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-cron-expressions.html
  - `scheduleId` string, uuid, required — Unique schedule identifier
  - `timezone` string, required — IANA timezone for schedule execution
  - `updatedAt` string, required — Schedule last update timestamp (ISO 8601)

## Other responses

- `401` — Authentication required
- `403` — Permission denied - connection admin role required
- `404` — Connection or schedule not found

---

[API](https://skmtc.net/omniapp/apis/omni-api.md) · [All operations](https://skmtc.net/omniapp/apis/omni-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/omniapp/omni-api/versions/4701f292c621/schema)