This API is available from ConfiForms version 2.18
ConfiForms API prefix is "/rest/confiforms/1.0"
Each API call expects you to provide at least the information about the page where the form is located (pageId - as number, pointing at Confluence page by ID - https://confluence.atlassian.com/confkb/how-to-get-confluence-page-id-648380445.html) and the form name (the name of the form you have given in ConfiForms Form Definition macro for the form).
...
Name | URL | Http Method | Description | Extra (query) parameters | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Create ConfiForms Entry | /rest/confiforms/1.0/create/{pageId}/{formName} | POST POST with multipart/form-data (from version 2.27) | Creates ConfiForms entry in the form | You will need to POST the following JSON structure to this REST API endpoint
Where each property name in the "fields" JSON object matches the field name in your ConfiForms Form, Values are expected to be in the internal format Values for Date/DateTime could be given in the same format as your Confluence uses or as timestamp
--- You can also POST a request with multipart/form-data. This comes handy when you want to upload attachments together with record creation. Please note that the parameter names must match the field names you have defined in your ConfiForms form
| |||||||||||||||
Update ConfiForms Entry | /rest/confiforms/1.0/update/{pageId}/{formName}/{id} | POST POST with multipart/form-data (from version 2.27) | Updates existing ConfiForms entry in the form (via {id} parameter) | Same as for create method, but with given UUID for the entry to perform an update
| |||||||||||||||
Validate ConfiForms Entry | /rest/confiforms/1.0/validate/{pageId}/{formName} /rest/confiforms/1.0/validate/{pageId}/{formName}/{id} | POST POST with multipart/form-data (from version 2.27) | Validates given data against the form's rules. Basically does the same as create/update, but does not do the actual "save" | Same JSON structure shall be given as with a "create" method | |||||||||||||||
Get form definition | /rest/confiforms/1.0/definition/{pageId}/{formName} | GET | Returns form configuration (definition) |
| |||||||||||||||
Get ConfiForms Entry by ID | /rest/confiforms/1.0/get/{pageId}/{formName}/{id} | GET | Returns ConfiForms entry data in JSON format by given ID (UUID) in a given form |
| |||||||||||||||
Search ConfiForms Entries by filter | /rest/confiforms/1.0/search/{pageId}/{formName} /rest/confiforms/1.0/search/{pageId}/{formName}/{filter} /rest/confiforms/1.0/search/{pageId}/{formName}?query={filter} | GET | Searches for ConfiForms entries in a form, based on the given filter/query (ConfiForms Filters). When filter is not specified all the entries are returned Filtering expression can be specified as "query" parameter as well |
| |||||||||||||||
Delete ConfiForms Entry by ID | /rest/confiforms/1.0/deleteById/{pageId}/{formName}/{id} | DELETE | Deletes ConfiForms entry by givenID (UUID) |
| |||||||||||||||
Delete ConfiForms Entries by filter | /rest/confiforms/1.0/deleteByFilter/{pageId}/{formName}/{filter}
/rest/confiforms/1.0/deleteByFilter/{pageId}/{formName}?query={filter} | DELETE | Deletes ConfiForms entry by given filter/query (ConfiForms Filters) |
| |||||||||||||||
Update ConfiForms Field value by filter | /rest/confiforms/1.0/updateFieldValue/{pageId}/{formName} /rest/confiforms/1.0/updateFieldValue/{pageId}/{formName}/{filter}
/rest/confiforms/1.0/updateFieldValue/{pageId}/{formName}?query={filter} | PUT | Updates specific field with a given value in the form, by filter (ConfiForms Filters). When filter is not specified the update is executed on all the entries |
| |||||||||||||||
Export RAW dataset
| /rest/confiforms/1.0/raw/{pageId}/{formName} | GET | Exports ConfiForms RAW dataset (which can be used with Migration and Recovery API) | ||||||||||||||||
ConfiForms installation info
| /rest/confiforms/1.0/info | GET | Provides information on current ConfiForms installation (user must be authenticated to access this resource) | Example
|
...