Endpoint URL: {identityDomain} /config/{appId} /flows/{flow} /locales/{locale} /fields/{field}
Description
Updates/replaces a field in the flow.
Respects the API Client Allow List: No
API Client Permissions
The following table indicates the API clients that can (and the API clients that can't) be used to call this endpoint:
owner | access_issuer | direct_access | direct_read_access | login_client |
Yes | No | Yes | No | No |
Authentication
This endpoint supports Basic authentication.
How to Create an Authentication String
Base URL
The base URL for this endpoint is your Configuration API domain followed by /config/ followed by your application ID. For example, if you are in the US region and your application ID is htb8fuhxnf8e38jrzub3c7pfrr, then your base URL would be:
https://v1.api.us.janrain.com/config/htb8fuhxnf8e38jrzub3c7pfrr
Request Example (application/json)
{
"type": "text",
"name": "myCustomTextField",
"schemaAttribute": "displayName",
"label": "foo",
"tip": "foo",
"socialProfileData": "profile.displayName",
"placeholder": "foo",
"validation": [
{
"rule": "required",
"value": true,
"message": "foo"
},
{
"rule": "unique",
"value": true,
"message": "foo"
}
]
}
Sample Request (curl)
This command updates the middleName field associated with the documentation flow.
curl -X PUT \ https://v1.api.us.janrain.com/config/htb8fuhxnf8e38jrzub3c7pfrr/flows/documentation/locales/en-US/fields/middleName \ -H 'Authorization: Basic
c2dueXZ1czZwYzRqbTdraHIybmVxNWdzODlnYnIyZXE6d3Q0YzN1bjl3a2tjZnZ5a25xeDQ0eW5jNDc2YWZzNjg=' \ -H 'Content-Type: application/json' \ -d '{ "schemaAttribute": "middleName", "name": "middleName", "type": "text", "tip": "", "placeholder": "Middle Name or Middle Initial", "_relationships": { "forms": [ { "name": "ccp_editProfileForm" }, { "name": "ccp_registrationForm" }, { "name": "editProfileForm" }, { "name": "registrationForm" }, { "name": "socialRegistrationForm" } ] }, "label": "Middle Name or Middle Initial" }'
Running this command in Postman
Responses
204 No Content
Successfully updated the Field.
404 Not Found
Field could not be found. Please check the value and try again.
{
"errors": "Field not found."
}