API Reference
- Getting Started
- Variables
- Measurements
- Analytics
- App Settings
- Data Import
- Feed
- Notifications
- Reminders
- Shares
- Studies
- Units
- User
Measurements
Save measurements
Store measurements representing things like a food eaten, a mood rating, or a medication taken. If the variable for the measurements does not already exist in the database, it will be automatically created.
POST
/
v3
/
measurements
/
post
curl --request POST \
--url https://safe.dfda.earth/api/v3/measurements/post \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '[
{
"startAt": "2022-01-01T00:00:00",
"value": "3",
"variableCategoryName": "Emotions",
"variableName": "Overall Mood",
"unitAbbreviatedName": "/5",
"combinationOperation": "Mean",
"sourceName": "<string>",
"upc": "<string>",
"note": "<string>"
}
]'
{
"data": {
"userVariables": [
"<any>"
],
"description": "<string>",
"summary": "<string>",
"errors": [
{
"message": "<string>"
}
],
"status": "<string>",
"success": true,
"code": 123,
"link": "<string>",
"card": {
"actionSheetButtons": [
{
"accessibilityText": "<string>",
"action": {},
"additionalInformation": "<string>",
"color": "<string>",
"confirmationText": "<string>",
"functionName": "<string>",
"parameters": {},
"html": "<string>",
"id": "<string>",
"image": "<string>",
"ionIcon": "<string>",
"link": "<string>",
"stateName": "<string>",
"stateParams": {},
"successToastText": "<string>",
"successAlertTitle": "<string>",
"successAlertBody": "<string>",
"text": "<string>",
"tooltip": "<string>",
"webhookUrl": "<string>"
}
],
"avatar": "<string>",
"avatarCircular": "<string>",
"backgroundColor": "<string>",
"buttons": [
{
"accessibilityText": "<string>",
"action": {},
"additionalInformation": "<string>",
"color": "<string>",
"confirmationText": "<string>",
"functionName": "<string>",
"parameters": {},
"html": "<string>",
"id": "<string>",
"image": "<string>",
"ionIcon": "<string>",
"link": "<string>",
"stateName": "<string>",
"stateParams": {},
"successToastText": "<string>",
"successAlertTitle": "<string>",
"successAlertBody": "<string>",
"text": "<string>",
"tooltip": "<string>",
"webhookUrl": "<string>"
}
],
"buttonsSecondary": [
{
"accessibilityText": "<string>",
"action": {},
"additionalInformation": "<string>",
"color": "<string>",
"confirmationText": "<string>",
"functionName": "<string>",
"parameters": {},
"html": "<string>",
"id": "<string>",
"image": "<string>",
"ionIcon": "<string>",
"link": "<string>",
"stateName": "<string>",
"stateParams": {},
"successToastText": "<string>",
"successAlertTitle": "<string>",
"successAlertBody": "<string>",
"text": "<string>",
"tooltip": "<string>",
"webhookUrl": "<string>"
}
],
"content": "<string>",
"headerTitle": "<string>",
"html": "<string>",
"htmlContent": "<string>",
"id": "<string>",
"image": "<string>",
"inputFields": [
{
"displayName": "<string>",
"helpText": "<string>",
"hint": "<string>",
"icon": "<string>",
"id": "<string>",
"image": "<string>",
"key": "<string>",
"labelLeft": "<string>",
"labelRight": "<string>",
"link": "<string>",
"maxLength": 123,
"maxValue": 123,
"minLength": 123,
"minValue": 123,
"options": [
"<string>"
],
"placeholder": "<string>",
"postUrl": "<string>",
"required": true,
"show": true,
"submitButton": {
"accessibilityText": "<string>",
"action": {},
"additionalInformation": "<string>",
"color": "<string>",
"confirmationText": "<string>",
"functionName": "<string>",
"parameters": {},
"html": "<string>",
"id": "<string>",
"image": "<string>",
"ionIcon": "<string>",
"link": "<string>",
"stateName": "<string>",
"stateParams": {},
"successToastText": "<string>",
"successAlertTitle": "<string>",
"successAlertBody": "<string>",
"text": "<string>",
"tooltip": "<string>",
"webhookUrl": "<string>"
},
"type": "check_box",
"validationPattern": "<string>",
"value": "<string>"
}
],
"ionIcon": "<string>",
"link": "<string>",
"parameters": {},
"selectedButton": {
"accessibilityText": "<string>",
"action": {},
"additionalInformation": "<string>",
"color": "<string>",
"confirmationText": "<string>",
"functionName": "<string>",
"parameters": {},
"html": "<string>",
"id": "<string>",
"image": "<string>",
"ionIcon": "<string>",
"link": "<string>",
"stateName": "<string>",
"stateParams": {},
"successToastText": "<string>",
"successAlertTitle": "<string>",
"successAlertBody": "<string>",
"text": "<string>",
"tooltip": "<string>",
"webhookUrl": "<string>"
},
"sharingBody": "<string>",
"sharingButtons": [
{
"accessibilityText": "<string>",
"action": {},
"additionalInformation": "<string>",
"color": "<string>",
"confirmationText": "<string>",
"functionName": "<string>",
"parameters": {},
"html": "<string>",
"id": "<string>",
"image": "<string>",
"ionIcon": "<string>",
"link": "<string>",
"stateName": "<string>",
"stateParams": {},
"successToastText": "<string>",
"successAlertTitle": "<string>",
"successAlertBody": "<string>",
"text": "<string>",
"tooltip": "<string>",
"webhookUrl": "<string>"
}
],
"sharingTitle": "<string>",
"subHeader": "<string>",
"subTitle": "<string>",
"title": "<string>"
}
},
"message": "<string>",
"description": "<string>",
"summary": "<string>",
"errors": [
{
"message": "<string>"
}
],
"status": "<string>",
"success": true,
"code": 123,
"card": {
"actionSheetButtons": [
{
"accessibilityText": "<string>",
"action": {},
"additionalInformation": "<string>",
"color": "<string>",
"confirmationText": "<string>",
"functionName": "<string>",
"parameters": {},
"html": "<string>",
"id": "<string>",
"image": "<string>",
"ionIcon": "<string>",
"link": "<string>",
"stateName": "<string>",
"stateParams": {},
"successToastText": "<string>",
"successAlertTitle": "<string>",
"successAlertBody": "<string>",
"text": "<string>",
"tooltip": "<string>",
"webhookUrl": "<string>"
}
],
"avatar": "<string>",
"avatarCircular": "<string>",
"backgroundColor": "<string>",
"buttons": [
{
"accessibilityText": "<string>",
"action": {},
"additionalInformation": "<string>",
"color": "<string>",
"confirmationText": "<string>",
"functionName": "<string>",
"parameters": {},
"html": "<string>",
"id": "<string>",
"image": "<string>",
"ionIcon": "<string>",
"link": "<string>",
"stateName": "<string>",
"stateParams": {},
"successToastText": "<string>",
"successAlertTitle": "<string>",
"successAlertBody": "<string>",
"text": "<string>",
"tooltip": "<string>",
"webhookUrl": "<string>"
}
],
"buttonsSecondary": [
{
"accessibilityText": "<string>",
"action": {},
"additionalInformation": "<string>",
"color": "<string>",
"confirmationText": "<string>",
"functionName": "<string>",
"parameters": {},
"html": "<string>",
"id": "<string>",
"image": "<string>",
"ionIcon": "<string>",
"link": "<string>",
"stateName": "<string>",
"stateParams": {},
"successToastText": "<string>",
"successAlertTitle": "<string>",
"successAlertBody": "<string>",
"text": "<string>",
"tooltip": "<string>",
"webhookUrl": "<string>"
}
],
"content": "<string>",
"headerTitle": "<string>",
"html": "<string>",
"htmlContent": "<string>",
"id": "<string>",
"image": "<string>",
"inputFields": [
{
"displayName": "<string>",
"helpText": "<string>",
"hint": "<string>",
"icon": "<string>",
"id": "<string>",
"image": "<string>",
"key": "<string>",
"labelLeft": "<string>",
"labelRight": "<string>",
"link": "<string>",
"maxLength": 123,
"maxValue": 123,
"minLength": 123,
"minValue": 123,
"options": [
"<string>"
],
"placeholder": "<string>",
"postUrl": "<string>",
"required": true,
"show": true,
"submitButton": {
"accessibilityText": "<string>",
"action": {},
"additionalInformation": "<string>",
"color": "<string>",
"confirmationText": "<string>",
"functionName": "<string>",
"parameters": {},
"html": "<string>",
"id": "<string>",
"image": "<string>",
"ionIcon": "<string>",
"link": "<string>",
"stateName": "<string>",
"stateParams": {},
"successToastText": "<string>",
"successAlertTitle": "<string>",
"successAlertBody": "<string>",
"text": "<string>",
"tooltip": "<string>",
"webhookUrl": "<string>"
},
"type": "check_box",
"validationPattern": "<string>",
"value": "<string>"
}
],
"ionIcon": "<string>",
"link": "<string>",
"parameters": {},
"selectedButton": {
"accessibilityText": "<string>",
"action": {},
"additionalInformation": "<string>",
"color": "<string>",
"confirmationText": "<string>",
"functionName": "<string>",
"parameters": {},
"html": "<string>",
"id": "<string>",
"image": "<string>",
"ionIcon": "<string>",
"link": "<string>",
"stateName": "<string>",
"stateParams": {},
"successToastText": "<string>",
"successAlertTitle": "<string>",
"successAlertBody": "<string>",
"text": "<string>",
"tooltip": "<string>",
"webhookUrl": "<string>"
},
"sharingBody": "<string>",
"sharingButtons": [
{
"accessibilityText": "<string>",
"action": {},
"additionalInformation": "<string>",
"color": "<string>",
"confirmationText": "<string>",
"functionName": "<string>",
"parameters": {},
"html": "<string>",
"id": "<string>",
"image": "<string>",
"ionIcon": "<string>",
"link": "<string>",
"stateName": "<string>",
"stateParams": {},
"successToastText": "<string>",
"successAlertTitle": "<string>",
"successAlertBody": "<string>",
"text": "<string>",
"tooltip": "<string>",
"webhookUrl": "<string>"
}
],
"sharingTitle": "<string>",
"subHeader": "<string>",
"subTitle": "<string>",
"title": "<string>"
}
}
Authorizations
Enter your bearer token in the format Bearer access_token_here
Body
application/json · object[]
An array of measurement sets containing measurement items you want to insert.
The body is of type object[]
.
Response
201
application/json
Successful operation
The response is of type object
.
curl --request POST \
--url https://safe.dfda.earth/api/v3/measurements/post \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '[
{
"startAt": "2022-01-01T00:00:00",
"value": "3",
"variableCategoryName": "Emotions",
"variableName": "Overall Mood",
"unitAbbreviatedName": "/5",
"combinationOperation": "Mean",
"sourceName": "<string>",
"upc": "<string>",
"note": "<string>"
}
]'
{
"data": {
"userVariables": [
"<any>"
],
"description": "<string>",
"summary": "<string>",
"errors": [
{
"message": "<string>"
}
],
"status": "<string>",
"success": true,
"code": 123,
"link": "<string>",
"card": {
"actionSheetButtons": [
{
"accessibilityText": "<string>",
"action": {},
"additionalInformation": "<string>",
"color": "<string>",
"confirmationText": "<string>",
"functionName": "<string>",
"parameters": {},
"html": "<string>",
"id": "<string>",
"image": "<string>",
"ionIcon": "<string>",
"link": "<string>",
"stateName": "<string>",
"stateParams": {},
"successToastText": "<string>",
"successAlertTitle": "<string>",
"successAlertBody": "<string>",
"text": "<string>",
"tooltip": "<string>",
"webhookUrl": "<string>"
}
],
"avatar": "<string>",
"avatarCircular": "<string>",
"backgroundColor": "<string>",
"buttons": [
{
"accessibilityText": "<string>",
"action": {},
"additionalInformation": "<string>",
"color": "<string>",
"confirmationText": "<string>",
"functionName": "<string>",
"parameters": {},
"html": "<string>",
"id": "<string>",
"image": "<string>",
"ionIcon": "<string>",
"link": "<string>",
"stateName": "<string>",
"stateParams": {},
"successToastText": "<string>",
"successAlertTitle": "<string>",
"successAlertBody": "<string>",
"text": "<string>",
"tooltip": "<string>",
"webhookUrl": "<string>"
}
],
"buttonsSecondary": [
{
"accessibilityText": "<string>",
"action": {},
"additionalInformation": "<string>",
"color": "<string>",
"confirmationText": "<string>",
"functionName": "<string>",
"parameters": {},
"html": "<string>",
"id": "<string>",
"image": "<string>",
"ionIcon": "<string>",
"link": "<string>",
"stateName": "<string>",
"stateParams": {},
"successToastText": "<string>",
"successAlertTitle": "<string>",
"successAlertBody": "<string>",
"text": "<string>",
"tooltip": "<string>",
"webhookUrl": "<string>"
}
],
"content": "<string>",
"headerTitle": "<string>",
"html": "<string>",
"htmlContent": "<string>",
"id": "<string>",
"image": "<string>",
"inputFields": [
{
"displayName": "<string>",
"helpText": "<string>",
"hint": "<string>",
"icon": "<string>",
"id": "<string>",
"image": "<string>",
"key": "<string>",
"labelLeft": "<string>",
"labelRight": "<string>",
"link": "<string>",
"maxLength": 123,
"maxValue": 123,
"minLength": 123,
"minValue": 123,
"options": [
"<string>"
],
"placeholder": "<string>",
"postUrl": "<string>",
"required": true,
"show": true,
"submitButton": {
"accessibilityText": "<string>",
"action": {},
"additionalInformation": "<string>",
"color": "<string>",
"confirmationText": "<string>",
"functionName": "<string>",
"parameters": {},
"html": "<string>",
"id": "<string>",
"image": "<string>",
"ionIcon": "<string>",
"link": "<string>",
"stateName": "<string>",
"stateParams": {},
"successToastText": "<string>",
"successAlertTitle": "<string>",
"successAlertBody": "<string>",
"text": "<string>",
"tooltip": "<string>",
"webhookUrl": "<string>"
},
"type": "check_box",
"validationPattern": "<string>",
"value": "<string>"
}
],
"ionIcon": "<string>",
"link": "<string>",
"parameters": {},
"selectedButton": {
"accessibilityText": "<string>",
"action": {},
"additionalInformation": "<string>",
"color": "<string>",
"confirmationText": "<string>",
"functionName": "<string>",
"parameters": {},
"html": "<string>",
"id": "<string>",
"image": "<string>",
"ionIcon": "<string>",
"link": "<string>",
"stateName": "<string>",
"stateParams": {},
"successToastText": "<string>",
"successAlertTitle": "<string>",
"successAlertBody": "<string>",
"text": "<string>",
"tooltip": "<string>",
"webhookUrl": "<string>"
},
"sharingBody": "<string>",
"sharingButtons": [
{
"accessibilityText": "<string>",
"action": {},
"additionalInformation": "<string>",
"color": "<string>",
"confirmationText": "<string>",
"functionName": "<string>",
"parameters": {},
"html": "<string>",
"id": "<string>",
"image": "<string>",
"ionIcon": "<string>",
"link": "<string>",
"stateName": "<string>",
"stateParams": {},
"successToastText": "<string>",
"successAlertTitle": "<string>",
"successAlertBody": "<string>",
"text": "<string>",
"tooltip": "<string>",
"webhookUrl": "<string>"
}
],
"sharingTitle": "<string>",
"subHeader": "<string>",
"subTitle": "<string>",
"title": "<string>"
}
},
"message": "<string>",
"description": "<string>",
"summary": "<string>",
"errors": [
{
"message": "<string>"
}
],
"status": "<string>",
"success": true,
"code": 123,
"card": {
"actionSheetButtons": [
{
"accessibilityText": "<string>",
"action": {},
"additionalInformation": "<string>",
"color": "<string>",
"confirmationText": "<string>",
"functionName": "<string>",
"parameters": {},
"html": "<string>",
"id": "<string>",
"image": "<string>",
"ionIcon": "<string>",
"link": "<string>",
"stateName": "<string>",
"stateParams": {},
"successToastText": "<string>",
"successAlertTitle": "<string>",
"successAlertBody": "<string>",
"text": "<string>",
"tooltip": "<string>",
"webhookUrl": "<string>"
}
],
"avatar": "<string>",
"avatarCircular": "<string>",
"backgroundColor": "<string>",
"buttons": [
{
"accessibilityText": "<string>",
"action": {},
"additionalInformation": "<string>",
"color": "<string>",
"confirmationText": "<string>",
"functionName": "<string>",
"parameters": {},
"html": "<string>",
"id": "<string>",
"image": "<string>",
"ionIcon": "<string>",
"link": "<string>",
"stateName": "<string>",
"stateParams": {},
"successToastText": "<string>",
"successAlertTitle": "<string>",
"successAlertBody": "<string>",
"text": "<string>",
"tooltip": "<string>",
"webhookUrl": "<string>"
}
],
"buttonsSecondary": [
{
"accessibilityText": "<string>",
"action": {},
"additionalInformation": "<string>",
"color": "<string>",
"confirmationText": "<string>",
"functionName": "<string>",
"parameters": {},
"html": "<string>",
"id": "<string>",
"image": "<string>",
"ionIcon": "<string>",
"link": "<string>",
"stateName": "<string>",
"stateParams": {},
"successToastText": "<string>",
"successAlertTitle": "<string>",
"successAlertBody": "<string>",
"text": "<string>",
"tooltip": "<string>",
"webhookUrl": "<string>"
}
],
"content": "<string>",
"headerTitle": "<string>",
"html": "<string>",
"htmlContent": "<string>",
"id": "<string>",
"image": "<string>",
"inputFields": [
{
"displayName": "<string>",
"helpText": "<string>",
"hint": "<string>",
"icon": "<string>",
"id": "<string>",
"image": "<string>",
"key": "<string>",
"labelLeft": "<string>",
"labelRight": "<string>",
"link": "<string>",
"maxLength": 123,
"maxValue": 123,
"minLength": 123,
"minValue": 123,
"options": [
"<string>"
],
"placeholder": "<string>",
"postUrl": "<string>",
"required": true,
"show": true,
"submitButton": {
"accessibilityText": "<string>",
"action": {},
"additionalInformation": "<string>",
"color": "<string>",
"confirmationText": "<string>",
"functionName": "<string>",
"parameters": {},
"html": "<string>",
"id": "<string>",
"image": "<string>",
"ionIcon": "<string>",
"link": "<string>",
"stateName": "<string>",
"stateParams": {},
"successToastText": "<string>",
"successAlertTitle": "<string>",
"successAlertBody": "<string>",
"text": "<string>",
"tooltip": "<string>",
"webhookUrl": "<string>"
},
"type": "check_box",
"validationPattern": "<string>",
"value": "<string>"
}
],
"ionIcon": "<string>",
"link": "<string>",
"parameters": {},
"selectedButton": {
"accessibilityText": "<string>",
"action": {},
"additionalInformation": "<string>",
"color": "<string>",
"confirmationText": "<string>",
"functionName": "<string>",
"parameters": {},
"html": "<string>",
"id": "<string>",
"image": "<string>",
"ionIcon": "<string>",
"link": "<string>",
"stateName": "<string>",
"stateParams": {},
"successToastText": "<string>",
"successAlertTitle": "<string>",
"successAlertBody": "<string>",
"text": "<string>",
"tooltip": "<string>",
"webhookUrl": "<string>"
},
"sharingBody": "<string>",
"sharingButtons": [
{
"accessibilityText": "<string>",
"action": {},
"additionalInformation": "<string>",
"color": "<string>",
"confirmationText": "<string>",
"functionName": "<string>",
"parameters": {},
"html": "<string>",
"id": "<string>",
"image": "<string>",
"ionIcon": "<string>",
"link": "<string>",
"stateName": "<string>",
"stateParams": {},
"successToastText": "<string>",
"successAlertTitle": "<string>",
"successAlertBody": "<string>",
"text": "<string>",
"tooltip": "<string>",
"webhookUrl": "<string>"
}
],
"sharingTitle": "<string>",
"subHeader": "<string>",
"subTitle": "<string>",
"title": "<string>"
}
}