Submit Public Form

View as Markdown

Submit a public form — authenticated by Laravel’s signed-URL middleware (no Bearer / pb-ectlid headers). All three URL params come from the Create Public Link response.

Query parameters

expiresstringOptional

Set by the Create Public Link test script — expiry on the submit signed URL (Laravel signs each URL separately, so this differs from the GET signature)

signaturestringOptional

Set by the Create Public Link test script — HMAC signature for the submit URL

Request

This endpoint expects a multipart form.
notesstringRequired

Optional: nullable|string — free-form submission notes

submittable_idstringRequired

Required: UUID (or numeric id) of the consuming record the submission belongs to — type must match the FormTemplate.assigned_to_type (e.g. work_order, customer, equipment)

submitter_namestringRequired

Optional: nullable|string|max:255 — name of the public submitter (recipient identification on public links)

submitter_emailstringRequired

Optional: nullable|email|max:255 — email of the public submitter

answers[0][value]stringRequired

Optional: nullable|mixed — the answer value (string, number, array, etc. depending on field_type)

answers[0][field_id]stringRequired

Required with answers: UUID (or numeric id) of the FormField the answer is for

answers[0][file_references]stringRequired

Optional: nullable|array — uploaded-file references for file-type fields

Response

Successful response