Create Form Instance

Create a new form instance from a form object schema. Requires READ or ADMIN permissions.

Parameters

name * are required parameters	data type	description
schemaId*	string	The object schema ID to create an instance from
body.data	object	Initial form field data
body.ownerIds	string[]	User IDs to set as owners of the form instance
body.assigneeIdsByState	object	Map of workflow states to assignee user IDs

Return Value

{
  "statusCode": 201,
  "message": "Form instance created",
  "data": { "...formInstance..." }
}

Error Codes

• 400 Bad Request: Returned when the schema does not exist or parameters are invalid.
• 401 Unauthorized: Returned when permissions are insufficient.

Examples

bash

curl -X POST "https://app.wombat.software/api/{targetPath}/form/:schemaId/create" \
  -H "Content-Type: application/json" \
  -H "Authentication: Bearer ..." \
  -d '{"data": {"fieldName": "value"}, "ownerIds": ["uid123"]}'