Duplicate form

curl --request POST \
  --url https://app.azalt.co/api/v1/forms/{id}/duplicate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "siteIds": [
    "<string>"
  ],
  "years": [
    123
  ],
  "name": "<string>",
  "organizationId": "<string>",
  "unitMapping": {}
}
'

{
  "id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "isPublic": true
}

Form

Duplicate form

Create a copy of an existing form with all elements, configurations, and settings. Requires site manager permissions.

Parameters:

id: Source form identifier to duplicate
newName: Name for the duplicated form (must be unique)
newDescription: Optional description override
siteIds: Target sites for deployment (can differ from source)
copySubmissions: Whether to copy existing submission data (default: false)

Duplication includes:

All form elements with identical configurations
Conditional logic and element dependencies
Validation rules and constraints
File upload settings and restrictions
Public access and security settings
Custom metadata and categorization

Customization Options:

Modify site deployment during duplication
Update form metadata while preserving structure
Choose whether to inherit submission data
Adjust period configurations for different timeframes

Common Use Cases:

Creating forms for new reporting periods (annual copies)
Deploying similar forms to different site groups
Template creation for standardized data collection
A/B testing different form configurations
Backup creation before major modifications
Regional customization of global forms

POST

forms

{id}

duplicate

Duplicate form

curl --request POST \
  --url https://app.azalt.co/api/v1/forms/{id}/duplicate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "siteIds": [
    "<string>"
  ],
  "years": [
    123
  ],
  "name": "<string>",
  "organizationId": "<string>",
  "unitMapping": {}
}
'

{
  "id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "isPublic": true
}

Authorizations

Authorization

string

header

required

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

Path Parameters

string

required

Body

application/json

siteIds

string[]

required

Minimum array length: 1

years

number[]

required

Minimum array length: 1

name

string

organizationId

string

unitMapping

object

Show child attributes

Response

Successful response

string

required

name

string

required

description

string | null

required

isPublic

boolean

required

Create forms from CSV List form import files