gitlab_update_schedule
DestructiveIdempotent
Update a GitLab CI schedule's fields (cron, ref, active, description). Pass schedule_id and the fields to change; omit variables to keep them intact, or provide new set to replace all.
Instructions
Update an existing schedule. Only provided fields change.
Destructive when variables is set: the entire variable set is replaced,
so ensure the caller sends a full list.
Examples:
- "Deactivate schedule 42" → schedule_id=42, active=False
- "Change cron of schedule 42 to hourly" → schedule_id=42, cron='0 * * * *'
- Don't pass variables unless you want to replace them entirely.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| schedule_id | Yes | Schedule ID to update. | |
| description | No | New description. | |
| cron | No | New cron expression. | |
| ref | No | New ref (branch/tag). | |
| active | No | New active state. | |
| variables | No | New variable set. If provided, **replaces all existing variables** — pre-existing ones are deleted first. Omit to leave variables untouched. | |
| 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 |