gitlab_update_schedule
DestructiveIdempotent
Modify GitLab CI/CD pipeline schedules by updating fields like cron expressions, active status, or variables. Replace entire variable sets when specified, or adjust specific schedule parameters without affecting others.
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 |