Skip to content

Submission State Workflow

There are currently three states for submissions: draft, submitted, and accepted. The set of allowed states for a form can be configured in the form attribute allowedSubmissionStates. By default, the only allowed state is submitted.

Drafts

Drafts, i.e. submissions in the draft state can only be accessed (read, updated, and deleted) by their creators and people who were granted ("shared") the respective permissions to the draft.

Note: Sharing of drafts is only possible if Grant-Based Authorization is enabled for the form.

Submissions

Submissions in the submitted state can be accessed by users with form level submission permissions:

  • read_submissions Read all submission of the form
  • update_submissions Update all submissions of the form
  • delete_submissions Delete all submissions of the form

Submissions in the submitted state can be accessed by users with submission level submission permissions if the respective granted actions are allowed for submissions of the form (see Allowed Actions when Submitted)

Accepted Submissions

Submission in the accepted state have similar access restrictions as submitted submissions, but can not be updated anymore. The only allowed modification is a change back to the submitted state, if the user has update_submissions permissions for the form.