# TimeTriggerIn

Time/smart schedule. Either friendly fields OR a raw cron, not both.

Type: object

Fields typed as another model are documented on that model's page; fetch it before filling the field.

| Field | Type | Required | Description | Allowed values / default / constraints |
| --- | --- | --- | --- | --- |
| `type` | string | yes | Selects a **time** trigger: the workflow runs on a schedule. Set either the friendly fields below or `cron`, not both. | const: `"time"` |
| `frequency` | string, nullable | no | Schedule frequency | one of: `"minutes"`, `"hourly"`, `"daily"`, `"weekly"`, `"monthly"` |
| `every` | integer, nullable | no | minutes: 15\|30 ; hourly: 1\|2\|4\|6\|8\|12 |  |
| `time` | string, nullable | no | HH:MM for daily/weekly/monthly. Minute is coerced to :00. |  |
| `weekday` | string or array of string, nullable | no | weekly only: a day name (sunday..saturday) or a list of names |  |
| `day_of_month` | integer or string, nullable | no | monthly only: 1..31 or 'last' |  |
| `cron` | string, nullable | no | Power-user escape hatch. Mutually exclusive with friendly fields. |  |
| `timezone` | string, nullable | no | IANA timezone; defaults to the workflow's current timezone. |  |

## Used by

- [PUT /rest/beta/workflows/{id}/trigger](https://dev-api.sheetgo.com/rest/reference/triggers.md#put-rest-beta-workflows-id-trigger)

---

More: start page https://dev-api.sheetgo.com/rest/reference.md, everything in one file https://dev-api.sheetgo.com/rest/llms-full.txt, OpenAPI https://dev-api.sheetgo.com/rest/openapi.json.
