form-builder-versions
4 Endpunkte. Basis-URL: https://xapi.ambertech.cloud/api/v1
List a form's version history (newest first)#
GET
/spaces/{spaceId}/forms/{formId}/versionsTokenParameter
| Name | Ort | Typ | Beschreibung |
|---|---|---|---|
spaceIdPflicht | Pfad | string | – |
formIdPflicht | Pfad | string | – |
Antworten
- 200OK
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/versions" \
-H "Authorization: Bearer $XISUITE_TOKEN"Manually snapshot the current form as a new version#
POST
/spaces/{spaceId}/forms/{formId}/versionsTokenParameter
| Name | Ort | Typ | Beschreibung |
|---|---|---|---|
spaceIdPflicht | Pfad | string | – |
formIdPflicht | Pfad | string | – |
Antworten
- 201Erstellt
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/versions" \
-H "Authorization: Bearer $XISUITE_TOKEN"Get one version with its field snapshot (read-only preview)#
GET
/spaces/{spaceId}/forms/{formId}/versions/{versionId}TokenParameter
| Name | Ort | Typ | Beschreibung |
|---|---|---|---|
spaceIdPflicht | Pfad | string | – |
formIdPflicht | Pfad | string | – |
versionIdPflicht | Pfad | string | – |
Antworten
- 200OK
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/versions/{versionId}" \
-H "Authorization: Bearer $XISUITE_TOKEN"Restore a version onto the live form (records a new version)#
POST
/spaces/{spaceId}/forms/{formId}/versions/{versionId}/restoreTokenParameter
| Name | Ort | Typ | Beschreibung |
|---|---|---|---|
spaceIdPflicht | Pfad | string | – |
formIdPflicht | Pfad | string | – |
versionIdPflicht | Pfad | string | – |
Request-Body
| Name | Typ | Beschreibung |
|---|---|---|
versionPflicht | number | Expected current form.version (optimistic lock). A mismatch → 409, so a concurrent edit is never silently overwritten. |
Antworten
- 201Erstellt
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/versions/{versionId}/restore" \
-H "Authorization: Bearer $XISUITE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"version":"3"}'