Submit a Form | Moveworks

This API is primarily used for transactional activity. Performance will be essential. The following example assumes submission of the example form defined here. Anticipated load – Moveworks will call this endpoint every time a user submits a form through our native skill.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

X-API-KEYstring

API Key authentication via header

Path parameters

formIdstringRequired

ID of form to submit

Request

This endpoint expects an object.

submitted_bystringRequired

System ID (usually the email address) of the user who submitted this form.

fieldsobjectOptional

This is a dictionary where they keys are the "field names" coming from the schema, and the value types are string, list of strings, and boolean. See the example.

form_metadataobjectOptional

Response headers

X-RateLimit-Limitinteger

The maximum number of requests you're permitted to make per minute.

X-RateLimit-Remaininginteger

The number of requests remaining in the current rate limit window.

X-RateLimit-Resetstring

The remaining window before the rate limit FULLY resets in UTC epoch seconds.

Response

Successful form submission

ticket_idstring

The display ticket ID of the ticket that was created (if any). null value is allowed. If a valid ticket ID is returned, Moveworks will be able to fetch/poll this ticket to provide updates to the user and to accelerate resolution of their request.

Bearer authentication of the form Bearer <token>, where token is your auth token.

API Key authentication via header

ID of form to submit

This endpoint expects an object.

System ID (usually the email address) of the user who submitted this form.

This is a dictionary where they keys are the "field names" coming from the schema, and the value types are string, list of strings, and boolean. See the example.

The maximum number of requests you're permitted to make per minute.

The number of requests remaining in the current rate limit window.

The remaining window before the rate limit FULLY resets in UTC epoch seconds.

Successful form submission

$	curl -X POST http://localhost:5000/myinstance1/forms/formId/submit \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"submitted_by": "one@example.com"
>	}'

$	curl -X POST http://localhost:5000/myinstance1/forms/formId/submit \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"submitted_by": "one@example.com"
>	}'