CreateForm
Creates a new form for an Amplify app.
Request Syntax
POST /app/appId/environment/environmentName/forms?clientToken=clientToken HTTP/1.1
Content-type: application/json
{
"cta": {
"cancel": {
"children": "string",
"excluded": boolean,
"position": { ... }
},
"clear": {
"children": "string",
"excluded": boolean,
"position": { ... }
},
"position": "string",
"submit": {
"children": "string",
"excluded": boolean,
"position": { ... }
}
},
"dataType": {
"dataSourceType": "string",
"dataTypeName": "string"
},
"fields": {
"string" : {
"excluded": boolean,
"inputType": {
"defaultChecked": boolean,
"defaultCountryCode": "string",
"defaultValue": "string",
"descriptiveText": "string",
"fileUploaderConfig": {
"acceptedFileTypes": [ "string" ],
"accessLevel": "string",
"isResumable": boolean,
"maxFileCount": number,
"maxSize": number,
"showThumbnails": boolean
},
"isArray": boolean,
"maxValue": number,
"minValue": number,
"name": "string",
"placeholder": "string",
"readOnly": boolean,
"required": boolean,
"step": number,
"type": "string",
"value": "string",
"valueMappings": {
"bindingProperties": {
"string" : {
"bindingProperties": {
"model": "string"
},
"type": "string"
}
},
"values": [
{
"displayValue": {
"bindingProperties": {
"field": "string",
"property": "string"
},
"concat": [
"FormInputValueProperty"
],
"value": "string"
},
"value": {
"bindingProperties": {
"field": "string",
"property": "string"
},
"concat": [
"FormInputValueProperty"
],
"value": "string"
}
}
]
}
},
"label": "string",
"position": { ... },
"validations": [
{
"numValues": [ number ],
"strValues": [ "string" ],
"type": "string",
"validationMessage": "string"
}
]
}
},
"formActionType": "string",
"labelDecorator": "string",
"name": "string",
"schemaVersion": "string",
"sectionalElements": {
"string" : {
"excluded": boolean,
"level": number,
"orientation": "string",
"position": { ... },
"text": "string",
"type": "string"
}
},
"style": {
"horizontalGap": { ... },
"outerPadding": { ... },
"verticalGap": { ... }
},
"tags": {
"string" : "string"
}
}URI Request Parameters
The request uses the following URI parameters.
- appId
-
The unique ID of the Amplify app to associate with the form.
Required: Yes
- clientToken
-
The unique client token.
- environmentName
-
The name of the backend environment that is a part of the Amplify app.
Required: Yes
Request Body
The request accepts the following data in JSON format.
- cta
-
The
FormCTAobject that stores the call to action configuration for the form.Type: FormCTA object
Required: No
- dataType
-
The type of data source to use to create the form.
Type: FormDataTypeConfig object
Required: Yes
- fields
-
The configuration information for the form's fields.
Type: String to FieldConfig object map
Required: Yes
- formActionType
-
Specifies whether to perform a create or update action on the form.
Type: String
Valid Values:
create | updateRequired: Yes
- labelDecorator
-
Specifies an icon or decoration to display on the form.
Type: String
Valid Values:
required | optional | noneRequired: No
- name
-
The name of the form.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 255.
Required: Yes
- schemaVersion
-
The schema version of the form.
Type: String
Required: Yes
- sectionalElements
-
The configuration information for the visual helper elements for the form. These elements are not associated with any data.
Type: String to SectionalElement object map
Required: Yes
- style
-
The configuration for the form's style.
Type: FormStyle object
Required: Yes
-
One or more key-value pairs to use when tagging the form data.
Type: String to string map
Key Length Constraints: Minimum length of 1. Maximum length of 128.
Key Pattern:
(?!aws:)[a-zA-Z+-=._:/]+Value Length Constraints: Minimum length of 1. Maximum length of 256.
Required: No
Response Syntax
HTTP/1.1 200
Content-type: application/json
{
"appId": "string",
"cta": {
"cancel": {
"children": "string",
"excluded": boolean,
"position": { ... }
},
"clear": {
"children": "string",
"excluded": boolean,
"position": { ... }
},
"position": "string",
"submit": {
"children": "string",
"excluded": boolean,
"position": { ... }
}
},
"dataType": {
"dataSourceType": "string",
"dataTypeName": "string"
},
"environmentName": "string",
"fields": {
"string" : {
"excluded": boolean,
"inputType": {
"defaultChecked": boolean,
"defaultCountryCode": "string",
"defaultValue": "string",
"descriptiveText": "string",
"fileUploaderConfig": {
"acceptedFileTypes": [ "string" ],
"accessLevel": "string",
"isResumable": boolean,
"maxFileCount": number,
"maxSize": number,
"showThumbnails": boolean
},
"isArray": boolean,
"maxValue": number,
"minValue": number,
"name": "string",
"placeholder": "string",
"readOnly": boolean,
"required": boolean,
"step": number,
"type": "string",
"value": "string",
"valueMappings": {
"bindingProperties": {
"string" : {
"bindingProperties": {
"model": "string"
},
"type": "string"
}
},
"values": [
{
"displayValue": {
"bindingProperties": {
"field": "string",
"property": "string"
},
"concat": [
"FormInputValueProperty"
],
"value": "string"
},
"value": {
"bindingProperties": {
"field": "string",
"property": "string"
},
"concat": [
"FormInputValueProperty"
],
"value": "string"
}
}
]
}
},
"label": "string",
"position": { ... },
"validations": [
{
"numValues": [ number ],
"strValues": [ "string" ],
"type": "string",
"validationMessage": "string"
}
]
}
},
"formActionType": "string",
"id": "string",
"labelDecorator": "string",
"name": "string",
"schemaVersion": "string",
"sectionalElements": {
"string" : {
"excluded": boolean,
"level": number,
"orientation": "string",
"position": { ... },
"text": "string",
"type": "string"
}
},
"style": {
"horizontalGap": { ... },
"outerPadding": { ... },
"verticalGap": { ... }
},
"tags": {
"string" : "string"
}
}Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
- appId
-
The unique ID of the Amplify app associated with the form.
Type: String
- cta
-
Stores the call to action configuration for the form.
Type: FormCTA object
- dataType
-
The type of data source to use to create the form.
Type: FormDataTypeConfig object
- environmentName
-
The name of the backend environment that is a part of the Amplify app.
Type: String
- fields
-
Stores the information about the form's fields.
Type: String to FieldConfig object map
- formActionType
-
The operation to perform on the specified form.
Type: String
Valid Values:
create | update - id
-
The unique ID of the form.
Type: String
- labelDecorator
-
Specifies an icon or decoration to display on the form.
Type: String
Valid Values:
required | optional | none - name
-
The name of the form.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 255.
- schemaVersion
-
The schema version of the form when it was imported.
Type: String
- sectionalElements
-
Stores the visual helper elements for the form that are not associated with any data.
Type: String to SectionalElement object map
- style
-
Stores the configuration for the form's style.
Type: FormStyle object
-
One or more key-value pairs to use when tagging the form.
Type: String to string map
Key Length Constraints: Minimum length of 1. Maximum length of 128.
Key Pattern:
(?!aws:)[a-zA-Z+-=._:/]+Value Length Constraints: Minimum length of 1. Maximum length of 256.
Errors
For information about the errors that are common to all actions, see Common Errors.
- InternalServerException
-
An internal error has occurred. Please retry your request.
HTTP Status Code: 500
- InvalidParameterException
-
An invalid or out-of-range value was supplied for the input parameter.
HTTP Status Code: 400
- ResourceConflictException
-
The resource specified in the request conflicts with an existing resource.
HTTP Status Code: 409
- ServiceQuotaExceededException
-
You exceeded your service quota. Service quotas, also referred to as limits, are the maximum number of service resources or operations for your AWS account.
HTTP Status Code: 402
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following:
