XISUITEDokumentation

form-builder-submissions

7 Endpunkte. Basis-URL: https://xapi.ambertech.cloud/api/v1

List submissions for a form (paginated)#

GET/spaces/{spaceId}/forms/{formId}/submissionsToken

Parameter

NameOrtTypBeschreibung
spaceIdPflichtPfadstring–
formIdPflichtPfadstring–
pageQuerynumber–
limitQuerynumber–

Antworten

  • 200OK
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/submissions" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Submit a response to a form#

POST/spaces/{spaceId}/forms/{formId}/submissionsToken

Parameter

NameOrtTypBeschreibung
spaceIdPflichtPfadstring–
formIdPflichtPfadstring–
user-agentPflichtHeaderstring–

Request-Bodyapplication/jsonCreateFormBuilderSubmissionDto

NameTypBeschreibung
dataPflichtobject

Answer map keyed by field_key (e.g. { field_123: "Ada" }).

is_testboolean

Marks a preview submission from the builder — bypasses the published-status gate and is excluded from response counts.

Standard: false

task_idstring

Links the response to an existing task (inline form on a task detail). Suppresses the form -> task creator; the task must be in the same space and organization.

surfacestring

Where the form was filled. Absent = the form's own page. A surface whose ticket switch is off creates no ticket.

Werte: wiki

Antworten

  • 201Erstellt
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/submissions" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"data":{}}'

Delete a single submission#

DELETE/spaces/{spaceId}/forms/{formId}/submissions/{submissionId}Token

Parameter

NameOrtTypBeschreibung
spaceIdPflichtPfadstring–
formIdPflichtPfadstring–
submissionIdPflichtPfadstring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X DELETE "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/submissions/{submissionId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Get the current user's saved draft for a form#

GET/spaces/{spaceId}/forms/{formId}/submissions/draftToken

Parameter

NameOrtTypBeschreibung
spaceIdPflichtPfadstring–
formIdPflichtPfadstring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/submissions/draft" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Save or update the current user's draft for a form#

POST/spaces/{spaceId}/forms/{formId}/submissions/draftToken

Parameter

NameOrtTypBeschreibung
spaceIdPflichtPfadstring–
formIdPflichtPfadstring–

Request-Bodyapplication/jsonCreateFormBuilderSubmissionDto

NameTypBeschreibung
dataPflichtobject

Answer map keyed by field_key (e.g. { field_123: "Ada" }).

is_testboolean

Marks a preview submission from the builder — bypasses the published-status gate and is excluded from response counts.

Standard: false

task_idstring

Links the response to an existing task (inline form on a task detail). Suppresses the form -> task creator; the task must be in the same space and organization.

surfacestring

Where the form was filled. Absent = the form's own page. A surface whose ticket switch is off creates no ticket.

Werte: wiki

Antworten

  • 200OK
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/submissions/draft" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"data":{}}'

Delete the current user's draft for a form#

DELETE/spaces/{spaceId}/forms/{formId}/submissions/draftToken

Parameter

NameOrtTypBeschreibung
spaceIdPflichtPfadstring–
formIdPflichtPfadstring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X DELETE "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/submissions/draft" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

List the submitted form responses that produced a task#

GET/spaces/{spaceId}/tasks/{taskId}/form-submissionsToken

Parameter

NameOrtTypBeschreibung
spaceIdPflichtPfadstring–
taskIdPflichtPfadstring–

Antworten

  • 200OK
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/tasks/{taskId}/form-submissions" \
  -H "Authorization: Bearer $XISUITE_TOKEN"
Stand: 25. Oktober 2026© 2026 XISUITE · AmberTech Solutions