Difference between revisions of "API Update Template Fields"
IVSWikiBlue (talk | contribs) |
IVSWikiBlue (talk | contribs) |
||
| Line 41: | Line 41: | ||
|- | |- | ||
|'''type''' | |'''type''' | ||
| − | |Field Type | + | |Field Type |
|no | |no | ||
|text | |text | ||
Latest revision as of 12:00, 7 March 2025
This API call will update an existing field on an existing template.
Contents
Resource URL
http://valt.example.com/api/v3/admin/templates/{templateid}/fields/{fieldid}/edit
Replace {templateid} with the actual id number of the template. Templates are numbered sequentially when added to VALT.
Replace {fieldid} with the actual id number of the fields. Fields are numbered sequentially when added to VALT.
Resource Information
| Method | POST |
| Headers | Content-Type:application/json |
| Response Type | JSON |
| Authentication Required | Yes |
Parameters
The JSON body must be properly formatted. All fields and values should be enclosed in double quotes and separated by a colon.
| Field Name | Description | Required | Example |
|---|---|---|---|
| on | Field is Enabled (True or False) | no | true |
| required | Field is Required (True or False) | no | false |
| type | Field Type | no | text |
| name | Field Name | no | Patient Name |
| data | Default Field Value | no | Jane Doe |
Response
| Code | Reason |
|---|---|
| 200 | Template Created Successfully |
| 400 | Invalid Request (See Response for Specific Error) |
| 401 | Unauthorized |
| 404 | Template Not Found |
| 500 | JSON Body Formatted Incorrectly |
| data | |
|---|---|
| id | Field ID |
| on | Field is Enabled (True or False) |
| req | Field is Required (True or False) |
| type | Field Type |
| name | Field Name |
| data | Default Field Value |
Examples
Request
The sample JSON body below is formatted with line breaks and indentation to make it easier to read. This is not required.
https://ivstest1.ad.ipivs.com/api/v3/admin/templates/52/fields/158/edit?access_token=e82632d19c523678fea3d1016c6df9e9
{
"on":true,
"required":true,
"type":"text",
"name":"Patient",
"data":"John Doe"
}
Successful Response
Sample response is shown with line breaks to make it more readable. Actual responses will not include line breaks.
{
"data":{
"id": 158,
"on": true,
"req": true,
"type": "text",
"name": "Patient",
"data": "John Doe"
}
}
Failure Response
Sample response is shown with line breaks to make it more readable. Actual responses will not include line breaks.
{
"error":{
"code": 500,
"message": "Internal Server Error"
}
}