Programs API: Errors

This article outlines error messages that might be issued when calling methods of the Programs API.

Update Program errors

The Update Program method might issue the following error messages:

HTTP statusError codeError messageTroubleshooting
FAILED_PRECONDITION (428)WRONG_STATEThe program is ended or archived and can't be updated.Refresh the program and avoid editing closed programs.
INVALID_ARGUMENT (400)WRONG_START_DATEThe requested start date is in the past for the site's timezone.Ask the owner to choose today or a future date.
INVALID_ARGUMENT (400)WRONG_PARTICIPANTS_NUMBERThe requested participant limit is lower than the number of active participants.Raise the limit or remove participants before updating.
FAILED_PRECONDITION (428)DUPLICATED_SLUGThe requested SEO slug already belongs to another program or conflicts with an existing program ID.Choose a unique slug and retry.
FAILED_PRECONDITION (428)TIMELINE_SWITCH_FORBIDDENTimeline settings can't be changed while the program has active participants.Keep the existing timeline or create a new program.

Publish Program errors

The Publish Program method might issue the following error message:

HTTP statusError codeError messageTroubleshooting
FAILED_PRECONDITION (428)INVALID_START_DATEThe program's start date is in the past.Update the timeline before publishing.

Visibility errors

Read methods might issue the following error message:

HTTP statusError codeError messageTroubleshooting
PERMISSION_DENIED (403)permission_deniedThe caller isn't allowed to view the requested program or result set.Check the caller identity and the program's access settings.

Date last updated: 22 June 2026

Did this help?