...
ConfiForms REST
...
Here is the list of REST endpoints and supported parameters for ConfiForms plugin
Both methods are supported:
pageId is a very important parameter and should be supplied always, as all the methods are executed when PAGE is known/defined, otherwise a NOT FOUND error is shown
See Atlassian guide how to find pageId parameter for the page -
https://confluence.atlassian.com/confkb/how-to-get-confluence-page-id-648380445.html
Table of Contents |
---|
Info | ||
---|---|---|
Adding "_skipIfParamIsEmpty" parameter with value "true" to your request helps to bypass setting all the fields - useful when you have field definitions with validations and you dont want to set / reset those with your REST API call
|
...
Code Block |
---|
http(s)://CONFLUENCE_SERVER/ajax/confiforms/rest/save.action?pageId=<PAGE_ID>&f=<FORM_NAME>&fields... |
Info |
---|
There is a way to create entries on behalf of the "page" - useful when you have "autopage" fields in your form In this case, use the "storagePageId" as the page location of your form, while "pageId" parameter use as the "current page" |
Code Block |
---|
http(s)://CONFLUENCE_SERVER/ajax/confiforms/rest/save.action?pageId=<PAGE_ID>&f=<FORM_NAME>&entryId=ID&fields... |
Code Block |
---|
http(s)://CONFLUENCE_SERVER/ajax/confiforms/delete.action?pageId=<PAGE_ID>®istrationFormName=<FORM_NAME>&entryId=<ID> |
...
Code Block |
---|
http(s)://CONFLUENCE_SERVER/ajax/confiforms/remove.action?pageId=<PAGE_ID>&f=<FORM_NAME>&q=<FILTER> |
Code Block |
---|
http(s)://CONFLUENCE_SERVER/ajax/confiforms/rest/update.action?pageId=<PAGE_ID>&f=<FORM_NAME>&q=<FILTER>&fv=field:value |
APIs for Server/Data Center version. If you are looking for integrations with ConfiForms for Confluence cloud then please refer to REST API for ConfiForms CLOUD
We maintain 2 versions of the API. Version 0 and Version 1 (available since ConfiForms 2.18 and supports Confluence PAT tokens as authentication method (https://confluence.atlassian.com/enterprise/using-personal-access-tokens-1026032365.html) and is also accessible through the REST API browser https://developer.atlassian.com/server/framework/atlassian-sdk/using-the-rest-api-browser/).
Children Display |
---|
Info | ||
---|---|---|
From ConfiForms version 1.49.2 you can use [entry.fieldname] in "fv" parameter (to reference the value from another field)
|
Code Block |
---|
http(s)://CONFLUENCE_SERVER/ajax/confiforms/rest/validate.action?pageId=<PAGE_ID>&f=<FORM_NAME>&fields... |
This method only validates if the data could be saved
Code Block |
---|
http(s)://CONFLUENCE_SERVER/ajax/confiforms/rest/filter.action?pageId=<PAGE_ID>&f=<FORM_NAME>&q=<QUERY> |
Info | ||
---|---|---|
From ConfiForms version 1.49.2 you can use additional "fields" parameter in the request to decorate the returned values with Virtual functions. Use "," to separate field decoration instructions
This translates to - try to apply camelCase virtual function on "myfield" and try to format "mydatefield" with the formatDate function and given pattern |
Info | ||
---|---|---|
From ConfiForms version 1.50, you can specify limits (limit) and sorting (sort)
Sorting variale expects the value as described here Sorting in ConfiForms |
Info |
---|
From ConfiForms version 1.53.3 you can use use "append=true" in your query which instructs the parameter "fields" to add the transformed (decorated) fields into the record. This allows you to have multiple representations of the field in the output. |
Code Block |
---|
http(s)://CONFLUENCE_SERVER/ajax/confiforms/rest/definition.action?pageId=<PAGE_ID>&f=<FORM_NAME> |
Since ConfiForms version 1.20 you are now able to attach files to ConfiForms records via REST API. Make sure you create a POST request and for larger files please consider using a multipart request instead, having file body sent via the file part, not via base64 encoded contents. In this case, do not set the "fv" parameter!
File should be encoded as BASE64 string
Code Block |
---|
http(s)://CONFLUENCE_SERVER/ajax/confiforms/rest/upload.action?pageId=<PAGE_ID>&f=<FORM_NAME>&q=<FILTER>&fv=<FIELD_NAME>:<BASE64ENCODED_STRING>&fileContentType=<CONTENT_TYPE>&fileName=<NAMEOFFILE> |
FIELD_NAME - name of the file followed by : and file contents encoded as BASE64 string
CONTENT_TYPE - file content type which you are trying to upload, expecting mime type, see https://www.sitepoint.com/web-foundations/mime-types-complete-list/
NAMEOFFILE - name of the file (will be visible as the name in attachments)
Warning |
---|
It is strongly advised to use POST for this operation and send the parameters not in the query string but using the HTTP POST method request parameters |
...