Submit Share

Submit a completed form response via a share link. Authentication is optional — anonymous submissions are allowed if the share configuration permits it.

Parameters

name * are required parameters	data type	description
shareId*	string	The unique share identifier
body*	object	The form field values to submit

The body accepts data, optional initialState or selectedState, and optional subEntries. Each subentry supplies entityId, type, optional data, and meta.parentLinkTargetPath. Subentries must match their subform field's type and configured IDs, when present. The API validates these references, uses the share's default assignees, and saves the root and up to 50 subentries together with parent/child links.

The server loads and checks the referenced published templates during submission; clients do not need to send template definitions fetched from the options API.

Return Value

Confirmation of the submitted form instance.

Examples

bash

curl -X POST "https://app.wombat.software/api/{targetPath}/share/:shareId/submit" \
  -H "Content-Type: application/json" \
  -d '{"fields": {"field-1": "value-1", "field-2": "value-2"}}'