Resolved Steps API: Errors

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

Upsert Resolved Step errors

The Upsert Resolved Step method might issue the following error messages:

HTTP status	Error code	Error message	Troubleshooting
NOT_FOUND (404)	PARTICIPANT_NOT_FOUND	PARTICIPANT_NOT_FOUND	Verify participantId and make sure the participant still exists.
NOT_FOUND (404)	STEP_NOT_FOUND	STEP_NOT_FOUND	Verify programStepId and make sure the step belongs to the same program as the participant.
NOT_FOUND (404)	QUIZ_SUBMISSION_NOT_FOUND	Quiz submission is not found.	Verify quizSubmissionId and make sure the quiz submission still exists.
INVALID_ARGUMENT (400)	QUIZ_SUBMISSION_STEP_MISMATCH	Quiz submission does not belong to the program step quiz.	Specify a submission for the quiz associated with the program step.
INVALID_ARGUMENT (400)	QUIZ_SUBMISSION_ID_REQUIRED	Quiz submission ID is required for quiz program steps.	Specify quizSubmissionId when upserting a quiz step, including when updating an existing resolved step. Omit it for non-quiz steps.
FAILED_PRECONDITION (428)	PARTICIPANT_NOT_JOINED	Participant is not joined to the program.	Make sure the participant's enrollmentStatus is JOINED.

Delete Resolved Step errors

The Delete Resolved Step method might issue the following error messages:

HTTP status	Error code	Error message	Troubleshooting
NOT_FOUND (404)	RESOLVED_STEP_NOT_FOUND	Resolved step is not found.	Verify resolvedStepId. You can use Query Resolved Steps to retrieve resolved-step IDs.
NOT_FOUND (404)	PARTICIPANT_NOT_FOUND	PARTICIPANT_NOT_FOUND	The participant referenced by the resolved step no longer exists. If the participant was recently removed, allow time for automatic resolved-step cleanup.
FAILED_PRECONDITION (428)	PARTICIPANT_NOT_JOINED	Participant is not joined to the program.	Manually delete resolved steps only while the participant's enrollmentStatus is JOINED. Resolved steps are deleted automatically when participants leave or are removed from programs.