Relocate form
Relocates a form to a different database. The form's records, their record history, and audit log are preserved and will be visible in the new database.
You must have permission to delete the form from its current database, and permission to add a form in the new database.
Request
POST https://www.activityinfo.org/resources/form/{formId}/database
Request body
application/json
| object | |||
| databaseId | string | The id of the database to which this form should be transferred | required |
Response
| Status Code | Error Code | Description |
|---|---|---|
| 200 | RELOCATED | The form has been successfully relocated. |
| 400 | CANNOT_ |
The source and target databases are the same. |
| 400 | SUB_ |
The form requested to relocate is a subform. Only top level forms can be relocated. |
| 401 | AUTHENTICATION_ |
The request must be authenticated |
| 403 | ADDING_ |
The authenticated user does not have permission to add the form to the target database. |
| 403 | DELETING_ |
The authenticated user does not have permission to delete the form from its current database. |
| 404 | DATABASE_ |
Either the source or target database does not exist. |
| 404 | FORM_ |
No such form with this id exists in the given database. |