gitlab_create_schedule
Create a new GitLab CI/CD schedule with a cron expression, branch, timezone, and variables. Each call generates a distinct schedule.
Instructions
Create a new CI/CD schedule with the given cron and variables.
Not idempotent: duplicate calls create duplicate schedules with auto-incrementing IDs.
Examples:
- "Schedule a nightly build on master at 02:00 Europe/Berlin" →
description='Nightly build', cron='0 2 * * *', ref='master',
timezone='Europe/Berlin', variables={'NIGHTLY': '1'}
- Don't use to update existing schedules — use gitlab_update_schedule.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| description | Yes | Human-readable description. | |
| cron | Yes | Cron expression in 5 fields (e.g. '0 2 * * *'). | |
| variables | Yes | CI variables to attach to the schedule (key -> value). | |
| ref | No | Branch or tag to run. | master |
| timezone | No | IANA timezone for the cron (e.g. 'Europe/Berlin'). | UTC |
| active | No | Activate the schedule immediately. | |
| project_path | No | GitLab project path (e.g. 'my-org/my-repo'). When omitted, the default from GITLAB_PROJECT_PATH env var is used. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| schedule_id | No | ||
| status | No | ||
| description | No | ||
| cron | No | ||
| ref | No | ||
| active | No |