form-builder

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

List every approval step waiting on the current user across all spaces#

GET/form-builder/approvals/mineToken

Antworten

200OK

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/form-builder/approvals/mine" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

List the current user's decided approvals (history) across all spaces#

GET/form-builder/approvals/mine/historyToken

Antworten

200OK

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/form-builder/approvals/mine/history" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

List every form assigned to the current user across all spaces#

GET/form-builder/assignments/mineToken

Antworten

200OK

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/form-builder/assignments/mine" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

List all forms in a space#

GET/spaces/{spaceId}/formsToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`includeArchived`Pflicht	Query	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Create a new form (status=draft)#

POST/spaces/{spaceId}/formsToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–

Request-Body`application/jsonCreateFormBuilderDto`

Name	Typ	Beschreibung
`name`Pflicht	`string`	–
`description`	`string`	–
`icon`	`string`	–
`settings`	`object`	–
`public_slug`	`string`	–

Antworten

201Form created

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"…"}'

Get a single form by ID#

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

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`formId`Pflicht	Pfad	`string`	–

Antworten

404Form not found

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Update a form (optimistic lock via version)#

PATCH/spaces/{spaceId}/forms/{formId}Token

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`formId`Pflicht	Pfad	`string`	–

Request-Body`application/jsonUpdateFormBuilderDto`

Name	Typ	Beschreibung
`version`Pflicht	`number`	Current version for optimistic locking
`name`	`string`	–
`description`	`object`	–
`icon`	`object`	–
`status`	`string`	Werte: `draftpublisheddisabledarchived`
`settings`	`object`	–
`public_slug`	`object`	–

Antworten

409Version conflict

Beispiel (cURL)

curl -X PATCH "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"version":0}'

Soft-delete a form (retains submissions)#

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

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`formId`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X DELETE "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Aggregated response analytics for a form#

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

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`formId`Pflicht	Pfad	`string`	–
`from`Pflicht	Query	`string`	–
`to`Pflicht	Query	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/analytics" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

List all approvals for a form#

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

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`formId`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/approvals" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Approval history (audit-log timeline) for a form#

GET/spaces/{spaceId}/forms/{formId}/approvals/historyToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`formId`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/approvals/history" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

List all assignments for a form#

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

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`formId`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/assignments" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Assign a form to users and/or roles#

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

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`formId`Pflicht	Pfad	`string`	–

Request-Body`application/jsonAssignFormDto`

Name	Typ	Beschreibung
`userIds`	`string[]`	public.users.id values
`roles`	`string[]`	Werte: `owneradminmemberviewer`
`dueAt`	`string`	ISO-8601 due date

Antworten

201Erstellt

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/assignments" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"userIds":[],"roles":"owner","dueAt":"…"}'

Remove a form assignment#

DELETE/spaces/{spaceId}/forms/{formId}/assignments/{assignmentId}Token

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`formId`Pflicht	Pfad	`string`	–
`assignmentId`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X DELETE "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/assignments/{assignmentId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Duplicate a form into a new draft#

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

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`formId`Pflicht	Pfad	`string`	–

Antworten

201Erstellt

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/duplicate" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

List a form’s native integrations#

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

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`formId`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/integrations" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Create a native integration#

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

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`formId`Pflicht	Pfad	`string`	–

Request-Body`application/jsonCreateIntegrationDto`

Name	Typ	Beschreibung
`provider`Pflicht	`string`	Werte: `gmailgithubairtableclickuptrellojirahubspotsalesforce`
`config`Pflicht	`object`	Provider config (Gmail: { fromEmail, fromName? })
`fieldMap`	`FieldMapEntry[]`	–
`fieldMap[].target`Pflicht	`string`	–
`fieldMap[].source`	`string`	–
`fieldMap[].template`	`string`	–
`credential`	`string`	Write-only; encrypted at rest and never returned.
`isActive`	`boolean`	–

Antworten

201Erstellt

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/integrations" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"provider":"gmail","config":{}}'

Update a native integration#

PATCH/spaces/{spaceId}/forms/{formId}/integrations/{integrationId}Token

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`formId`Pflicht	Pfad	`string`	–
`integrationId`Pflicht	Pfad	`string`	–

Request-Body`application/jsonUpdateIntegrationDto`

Name	Typ	Beschreibung
`config`	`object`	Provider config (Gmail: { fromEmail, fromName? })
`fieldMap`	`FieldMapEntry[]`	–
`fieldMap[].target`Pflicht	`string`	–
`fieldMap[].source`	`string`	–
`fieldMap[].template`	`string`	–
`credential`	`string`	Write-only; encrypted at rest and never returned.
`isActive`	`boolean`	–

Antworten

200OK

Beispiel (cURL)

curl -X PATCH "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/integrations/{integrationId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"config":{},"fieldMap":[],"credential":"…"}'

Delete a native integration#

DELETE/spaces/{spaceId}/forms/{formId}/integrations/{integrationId}Token

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`formId`Pflicht	Pfad	`string`	–
`integrationId`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X DELETE "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/integrations/{integrationId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

List recent delivery attempts for a native integration#

GET/spaces/{spaceId}/forms/{formId}/integrations/{integrationId}/deliveriesToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`formId`Pflicht	Pfad	`string`	–
`integrationId`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/integrations/{integrationId}/deliveries" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Send a test event to a native integration#

POST/spaces/{spaceId}/forms/{formId}/integrations/{integrationId}/testToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`formId`Pflicht	Pfad	`string`	–
`integrationId`Pflicht	Pfad	`string`	–

Antworten

201Erstellt

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/integrations/{integrationId}/test" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

List the connected Airtable account’s bases#

POST/spaces/{spaceId}/forms/{formId}/integrations/airtable/basesToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`formId`Pflicht	Pfad	`string`	–

Request-Body`application/jsonListAirtableBasesDto`

Name	Typ	Beschreibung
`credential`	`string`	Airtable Personal Access Token to list bases with. Omit to reuse the stored credential.

Antworten

201Erstellt

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/integrations/airtable/bases" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"credential":"…"}'

List the tables inside an Airtable base#

POST/spaces/{spaceId}/forms/{formId}/integrations/airtable/tablesToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`formId`Pflicht	Pfad	`string`	–

Request-Body`application/jsonListAirtableTablesDto`

Name	Typ	Beschreibung
`baseId`Pflicht	`string`	Airtable base ID (e.g. appXXXXXXXXXXXXXX) to list tables for.
`credential`	`string`	Airtable Personal Access Token. Omit to reuse the stored credential.

Antworten

201Erstellt

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/integrations/airtable/tables" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"baseId":"…"}'

List the connected ClickUp account’s Lists#

POST/spaces/{spaceId}/forms/{formId}/integrations/clickup/listsToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`formId`Pflicht	Pfad	`string`	–

Request-Body`application/jsonListClickupListsDto`

Name	Typ	Beschreibung
`credential`	`string`	ClickUp personal token to list Lists with. Omit to reuse the stored credential.

Antworten

201Erstellt

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/integrations/clickup/lists" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"credential":"…"}'

List the connected GitHub account’s repositories#

POST/spaces/{spaceId}/forms/{formId}/integrations/github/repositoriesToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`formId`Pflicht	Pfad	`string`	–

Request-Body`application/jsonListGithubReposDto`

Name	Typ	Beschreibung
`credential`	`string`	GitHub PAT; falls back to the stored token.

Antworten

201Erstellt

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/integrations/github/repositories" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"credential":"…"}'

List writable HubSpot contact properties#

POST/spaces/{spaceId}/forms/{formId}/integrations/hubspot/propertiesToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`formId`Pflicht	Pfad	`string`	–

Request-Body`application/jsonListHubspotPropertiesDto`

Name	Typ	Beschreibung
`credential`	`string`	HubSpot Private App token to list contact properties with. Omit to reuse the stored credential.

Antworten

201Erstellt

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/integrations/hubspot/properties" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"credential":"…"}'

List the creatable issue types in a Jira project#

POST/spaces/{spaceId}/forms/{formId}/integrations/jira/issue-typesToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`formId`Pflicht	Pfad	`string`	–

Request-Body`application/jsonListJiraIssueTypesDto`

Name	Typ	Beschreibung
`siteUrl`Pflicht	`string`	Atlassian site, e.g. https://your-site.atlassian.net
`email`Pflicht	`string`	Atlassian account email the API token belongs to.
`projectKey`Pflicht	`string`	Project key to list creatable issue types for, e.g. ENG.
`credential`	`string`	Atlassian API token. Omit to reuse the stored credential.

Antworten

201Erstellt

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/integrations/jira/issue-types" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"siteUrl":"…","email":"…","projectKey":"…"}'

List the connected Jira account’s projects#

POST/spaces/{spaceId}/forms/{formId}/integrations/jira/projectsToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`formId`Pflicht	Pfad	`string`	–

Request-Body`application/jsonListJiraProjectsDto`

Name	Typ	Beschreibung
`siteUrl`Pflicht	`string`	Atlassian site, e.g. https://your-site.atlassian.net
`email`Pflicht	`string`	Atlassian account email the API token belongs to.
`credential`	`string`	Atlassian API token. Omit to reuse the stored credential.

Antworten

201Erstellt

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/integrations/jira/projects" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"siteUrl":"…","email":"…"}'

List createable Salesforce Lead fields#

POST/spaces/{spaceId}/forms/{formId}/integrations/salesforce/fieldsToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`formId`Pflicht	Pfad	`string`	–

Request-Body`application/jsonListSalesforceFieldsDto`

Name	Typ	Beschreibung
`instanceUrl`Pflicht	`string`	Salesforce instance URL, e.g. https://your-org.my.salesforce.com

Antworten

201Erstellt

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/integrations/salesforce/fields" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"instanceUrl":"…"}'

List the connected Trello account’s Lists#

POST/spaces/{spaceId}/forms/{formId}/integrations/trello/listsToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`formId`Pflicht	Pfad	`string`	–

Request-Body`application/jsonListTrelloListsDto`

Name	Typ	Beschreibung
`apiKey`Pflicht	`string`	Trello API key used to list the boards’ Lists.
`credential`	`string`	Trello token to list Lists with. Omit to reuse the stored credential.

Antworten

201Erstellt

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/integrations/trello/lists" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"apiKey":"…"}'

Enable or disable the public link for a form#

PATCH/spaces/{spaceId}/forms/{formId}/public-linkToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`formId`Pflicht	Pfad	`string`	–

Request-Body`application/jsonUpdateFormPublicLinkDto`

Keine Felder dokumentiert.

Antworten

409Slug already taken or reserved

Beispiel (cURL)

curl -X PATCH "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/public-link" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Save a form as a reusable template#

POST/spaces/{spaceId}/forms/{formId}/save-as-templateToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`formId`Pflicht	Pfad	`string`	–

Antworten

201Erstellt

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/save-as-template" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

List task field role mappings for a form#

GET/spaces/{spaceId}/forms/{formId}/task-field-rolesToken

Parameter

Name	Ort	Typ	Beschreibung
`formId`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/task-field-roles" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Sync (replace) all task field role mappings for a form#

PUT/spaces/{spaceId}/forms/{formId}/task-field-rolesToken

Parameter

Name	Ort	Typ	Beschreibung
`formId`Pflicht	Pfad	`string`	–

Request-Body`application/jsonSyncTaskFieldRolesDto`

Name	Typ	Beschreibung
`space_id`Pflicht	`string`	The space where tasks will be created
`mappings`Pflicht	`object`	Map of task field → form field_key (null to clear)

Antworten

200OK

Beispiel (cURL)

curl -X PUT "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/task-field-roles" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"space_id":"…","mappings":{}}'

List a form’s outbound webhooks#

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

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`formId`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/webhooks" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Create an outbound webhook#

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

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`formId`Pflicht	Pfad	`string`	–

Request-Body`application/jsonCreateWebhookDto`

Name	Typ	Beschreibung
`provider`	`string`	Werte: `genericslackdiscordteamsgooglechatmattermostrocketchatzohocliqwebextelegramzapiermaken8npipedreamiftttpowerautomateairtablegooglesheets` Standard: `"generic"`
`url`Pflicht	`string`	HTTPS endpoint that receives the POST
`events`	`string[]`	Werte: `submission.created`
`secret`	`string`	Optional HMAC signing secret (write-only)
`isActive`	`boolean`	Standard: `true`

Antworten

201Erstellt

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/webhooks" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"…"}'

Update an outbound webhook#

PATCH/spaces/{spaceId}/forms/{formId}/webhooks/{webhookId}Token

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`formId`Pflicht	Pfad	`string`	–
`webhookId`Pflicht	Pfad	`string`	–

Request-Body`application/jsonUpdateWebhookDto`

Name	Typ	Beschreibung
`provider`	`string`	Werte: `genericslackdiscordteamsgooglechatmattermostrocketchatzohocliqwebextelegramzapiermaken8npipedreamiftttpowerautomateairtablegooglesheets` Standard: `"generic"`
`url`	`string`	HTTPS endpoint that receives the POST
`events`	`string[]`	Werte: `submission.created`
`secret`	`string`	Optional HMAC signing secret (write-only)
`isActive`	`boolean`	Standard: `true`

Antworten

200OK

Beispiel (cURL)

curl -X PATCH "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/webhooks/{webhookId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"provider":"generic","url":"…","events":"submission.created"}'

Delete an outbound webhook#

DELETE/spaces/{spaceId}/forms/{formId}/webhooks/{webhookId}Token

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`formId`Pflicht	Pfad	`string`	–
`webhookId`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X DELETE "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/webhooks/{webhookId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

List recent delivery attempts for a webhook#

GET/spaces/{spaceId}/forms/{formId}/webhooks/{webhookId}/deliveriesToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`formId`Pflicht	Pfad	`string`	–
`webhookId`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/webhooks/{webhookId}/deliveries" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Send a test payload to a webhook#

POST/spaces/{spaceId}/forms/{formId}/webhooks/{webhookId}/testToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`formId`Pflicht	Pfad	`string`	–
`webhookId`Pflicht	Pfad	`string`	–

Antworten

201Erstellt

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/{formId}/webhooks/{webhookId}/test" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

List approval steps waiting on the current user#

GET/spaces/{spaceId}/forms/approvals/mineToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/approvals/mine" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Approve or reject an approval step#

POST/spaces/{spaceId}/forms/approvals/steps/{stepId}/decideToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`stepId`Pflicht	Pfad	`string`	–

Request-Body`application/jsonDecideApprovalDto`

Name	Typ	Beschreibung
`decision`Pflicht	`string`	Werte: `approvedrejected`
`comment`	`string`	Reviewer note (required on reject when the form enforces it)

Antworten

201Erstellt

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/approvals/steps/{stepId}/decide" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"decision":"approved"}'

List forms assigned to the current user#

GET/spaces/{spaceId}/forms/assignments/mineToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/assignments/mine" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

List saved form templates in a space#

GET/spaces/{spaceId}/forms/templatesToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/templates" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Create a new draft form from a template#

POST/spaces/{spaceId}/forms/templates/{templateId}/instantiateToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`templateId`Pflicht	Pfad	`string`	–

Antworten

201Erstellt

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/templates/{templateId}/instantiate" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Check a reCAPTCHA key pair against Google (advisory)#

POST/spaces/{spaceId}/forms/tools/recaptcha-key-checkToken

Request-Body`application/jsonCheckRecaptchaKeysDto`

Name	Typ	Beschreibung
`site_key`	`string`	reCAPTCHA site key (public half).
`secret_key`	`string`	reCAPTCHA secret key. Never logged or echoed back.
`origin`	`string`	Origin the widget will run on, e.g. https://forms.example.com. Google validates the key against it, so without one every size check returns a false negative.

Antworten

200OK

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/forms/tools/recaptcha-key-check" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"site_key":"…","secret_key":"…","origin":"…"}'

Get the space’s Stripe connection (secrets redacted)#

GET/spaces/{spaceId}/payment-configToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/payment-config" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Connect / update the space’s Stripe credentials#

PUT/spaces/{spaceId}/payment-configToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–

Request-Body`application/jsonSavePaymentConfigDto`

Name	Typ	Beschreibung
`publishableKey`	`string`	Stripe publishable key (pk_...).
`secretKey`	`string`	Stripe secret key (sk_...). Write-only.
`webhookSecret`	`string`	Stripe webhook signing secret (whsec_...). Write-only.
`isActive`	`boolean`	Standard: `true`

Antworten

200OK

Beispiel (cURL)

curl -X PUT "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/payment-config" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"publishableKey":"…","secretKey":"…","webhookSecret":"…"}'

List the connected Stripe account’s active products#

GET/spaces/{spaceId}/payment-config/stripe/productsToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/payment-config/stripe/products" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Create a product + price in the connected Stripe account#

POST/spaces/{spaceId}/payment-config/stripe/productsToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–

Request-Body`application/jsonCreateStripeProductDto`

Name	Typ	Beschreibung
`name`Pflicht	`string`	–
`price`Pflicht	`number`	Price in major units (e.g. dollars).
`currency`Pflicht	`string`	ISO currency code, e.g. USD.
`description`	`string`	–
`image`	`string`	–

Antworten

201Erstellt

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/payment-config/stripe/products" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"…","price":0,"currency":"…"}'

form-builder

List every approval step waiting on the current user across all spaces#

Antworten

List the current user's decided approvals (history) across all spaces#

Antworten

List every form assigned to the current user across all spaces#

Antworten

List all forms in a space#

Parameter

Antworten

Create a new form (status=draft)#

Parameter

Request-Bodyapplication/jsonCreateFormBuilderDto

Antworten

Get a single form by ID#

Parameter

Antworten

Update a form (optimistic lock via version)#

Parameter

Request-Bodyapplication/jsonUpdateFormBuilderDto

Antworten

Soft-delete a form (retains submissions)#

Parameter

Antworten

Aggregated response analytics for a form#

Parameter

Antworten

List all approvals for a form#

Parameter

Antworten

Approval history (audit-log timeline) for a form#

Parameter

Antworten

List all assignments for a form#

Parameter

Antworten

Assign a form to users and/or roles#

Parameter

Request-Bodyapplication/jsonAssignFormDto

Antworten

Remove a form assignment#

Parameter

Antworten

Duplicate a form into a new draft#

Parameter

Antworten

List a form’s native integrations#

Parameter

Antworten

Create a native integration#

Parameter

Request-Bodyapplication/jsonCreateIntegrationDto

Antworten

Update a native integration#

Parameter

Request-Bodyapplication/jsonUpdateIntegrationDto

Antworten

Delete a native integration#

Parameter

Antworten

List recent delivery attempts for a native integration#

Parameter

Antworten

Send a test event to a native integration#

Parameter

Antworten

List the connected Airtable account’s bases#

Parameter

Request-Bodyapplication/jsonListAirtableBasesDto

Antworten

List the tables inside an Airtable base#

Parameter

Request-Bodyapplication/jsonListAirtableTablesDto

Antworten

List the connected ClickUp account’s Lists#

Parameter

Request-Bodyapplication/jsonListClickupListsDto

Antworten

List the connected GitHub account’s repositories#

Parameter

Request-Body`application/jsonCreateFormBuilderDto`

Request-Body`application/jsonUpdateFormBuilderDto`

Request-Body`application/jsonAssignFormDto`

Request-Body`application/jsonCreateIntegrationDto`

Request-Body`application/jsonUpdateIntegrationDto`

Request-Body`application/jsonListAirtableBasesDto`

Request-Body`application/jsonListAirtableTablesDto`

Request-Body`application/jsonListClickupListsDto`

Request-Body`application/jsonListGithubReposDto`

Request-Body`application/jsonListHubspotPropertiesDto`

Request-Body`application/jsonListJiraIssueTypesDto`

Request-Body`application/jsonListJiraProjectsDto`

Request-Body`application/jsonListSalesforceFieldsDto`

Request-Body`application/jsonListTrelloListsDto`

Request-Body`application/jsonUpdateFormPublicLinkDto`

Request-Body`application/jsonSyncTaskFieldRolesDto`

Request-Body`application/jsonCreateWebhookDto`

Request-Body`application/jsonUpdateWebhookDto`

Request-Body`application/jsonDecideApprovalDto`