This article outlines error messages that might be issued when calling methods of the Programs API.
The Update Program method might issue the following error messages:
| HTTP status | Error code | Error message | Troubleshooting |
|---|---|---|---|
FAILED_PRECONDITION (428) | WRONG_STATE | The program is ended or archived and can't be updated. | Refresh the program and avoid editing closed programs. |
INVALID_ARGUMENT (400) | WRONG_START_DATE | The 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_NUMBER | The requested participant limit is lower than the number of active participants. | Raise the limit or remove participants before updating. |
FAILED_PRECONDITION (428) | DUPLICATED_SLUG | The 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_FORBIDDEN | Timeline settings can't be changed while the program has active participants. | Keep the existing timeline or create a new program. |
The Publish Program method might issue the following error message:
| HTTP status | Error code | Error message | Troubleshooting |
|---|---|---|---|
FAILED_PRECONDITION (428) | INVALID_START_DATE | The program's start date is in the past. | Update the timeline before publishing. |
Read methods might issue the following error message:
| HTTP status | Error code | Error message | Troubleshooting |
|---|---|---|---|
PERMISSION_DENIED (403) | permission_denied | The 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