Update a goal
curl --request PUT \
--url https://api.example.com/users/{user_guid}/goals/{goal_guid} \
--header 'Content-Type: application/json' \
--data '
{
"goal": {
"account_guid": "<string>",
"amount": 123,
"goal_type_name": "<string>",
"meta_type_name": "<string>",
"name": "<string>",
"completed_at": "<string>",
"has_been_spent": true,
"is_complete": true
}
}
'import requests
url = "https://api.example.com/users/{user_guid}/goals/{goal_guid}"
payload = { "goal": {
"account_guid": "<string>",
"amount": 123,
"goal_type_name": "<string>",
"meta_type_name": "<string>",
"name": "<string>",
"completed_at": "<string>",
"has_been_spent": True,
"is_complete": True
} }
headers = {"Content-Type": "application/json"}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
goal: {
account_guid: '<string>',
amount: 123,
goal_type_name: '<string>',
meta_type_name: '<string>',
name: '<string>',
completed_at: '<string>',
has_been_spent: true,
is_complete: true
}
})
};
fetch('https://api.example.com/users/{user_guid}/goals/{goal_guid}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/users/{user_guid}/goals/{goal_guid}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'goal' => [
'account_guid' => '<string>',
'amount' => 123,
'goal_type_name' => '<string>',
'meta_type_name' => '<string>',
'name' => '<string>',
'completed_at' => '<string>',
'has_been_spent' => true,
'is_complete' => true
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/users/{user_guid}/goals/{goal_guid}"
payload := strings.NewReader("{\n \"goal\": {\n \"account_guid\": \"<string>\",\n \"amount\": 123,\n \"goal_type_name\": \"<string>\",\n \"meta_type_name\": \"<string>\",\n \"name\": \"<string>\",\n \"completed_at\": \"<string>\",\n \"has_been_spent\": true,\n \"is_complete\": true\n }\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.example.com/users/{user_guid}/goals/{goal_guid}")
.header("Content-Type", "application/json")
.body("{\n \"goal\": {\n \"account_guid\": \"<string>\",\n \"amount\": 123,\n \"goal_type_name\": \"<string>\",\n \"meta_type_name\": \"<string>\",\n \"name\": \"<string>\",\n \"completed_at\": \"<string>\",\n \"has_been_spent\": true,\n \"is_complete\": true\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/users/{user_guid}/goals/{goal_guid}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"goal\": {\n \"account_guid\": \"<string>\",\n \"amount\": 123,\n \"goal_type_name\": \"<string>\",\n \"meta_type_name\": \"<string>\",\n \"name\": \"<string>\",\n \"completed_at\": \"<string>\",\n \"has_been_spent\": true,\n \"is_complete\": true\n }\n}"
response = http.request(request)
puts response.read_bodyGoals
Update a goal
This endpoint updates a specific goal. This endpoint accepts the optional MX-Skip-Webhook header and skip_webhook parameter.
PUT
/
users
/
{user_guid}
/
goals
/
{goal_guid}
Update a goal
curl --request PUT \
--url https://api.example.com/users/{user_guid}/goals/{goal_guid} \
--header 'Content-Type: application/json' \
--data '
{
"goal": {
"account_guid": "<string>",
"amount": 123,
"goal_type_name": "<string>",
"meta_type_name": "<string>",
"name": "<string>",
"completed_at": "<string>",
"has_been_spent": true,
"is_complete": true
}
}
'import requests
url = "https://api.example.com/users/{user_guid}/goals/{goal_guid}"
payload = { "goal": {
"account_guid": "<string>",
"amount": 123,
"goal_type_name": "<string>",
"meta_type_name": "<string>",
"name": "<string>",
"completed_at": "<string>",
"has_been_spent": True,
"is_complete": True
} }
headers = {"Content-Type": "application/json"}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
goal: {
account_guid: '<string>',
amount: 123,
goal_type_name: '<string>',
meta_type_name: '<string>',
name: '<string>',
completed_at: '<string>',
has_been_spent: true,
is_complete: true
}
})
};
fetch('https://api.example.com/users/{user_guid}/goals/{goal_guid}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/users/{user_guid}/goals/{goal_guid}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'goal' => [
'account_guid' => '<string>',
'amount' => 123,
'goal_type_name' => '<string>',
'meta_type_name' => '<string>',
'name' => '<string>',
'completed_at' => '<string>',
'has_been_spent' => true,
'is_complete' => true
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/users/{user_guid}/goals/{goal_guid}"
payload := strings.NewReader("{\n \"goal\": {\n \"account_guid\": \"<string>\",\n \"amount\": 123,\n \"goal_type_name\": \"<string>\",\n \"meta_type_name\": \"<string>\",\n \"name\": \"<string>\",\n \"completed_at\": \"<string>\",\n \"has_been_spent\": true,\n \"is_complete\": true\n }\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.example.com/users/{user_guid}/goals/{goal_guid}")
.header("Content-Type", "application/json")
.body("{\n \"goal\": {\n \"account_guid\": \"<string>\",\n \"amount\": 123,\n \"goal_type_name\": \"<string>\",\n \"meta_type_name\": \"<string>\",\n \"name\": \"<string>\",\n \"completed_at\": \"<string>\",\n \"has_been_spent\": true,\n \"is_complete\": true\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/users/{user_guid}/goals/{goal_guid}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"goal\": {\n \"account_guid\": \"<string>\",\n \"amount\": 123,\n \"goal_type_name\": \"<string>\",\n \"meta_type_name\": \"<string>\",\n \"name\": \"<string>\",\n \"completed_at\": \"<string>\",\n \"has_been_spent\": true,\n \"is_complete\": true\n }\n}"
response = http.request(request)
puts response.read_bodyPath Parameters
The unique identifier for the user. Defined by MX.
The unique identifier for the goal. Defined by MX.
Request Body
Show goal
Show goal
Unique identifier of the account for the goal.
Amount of the goal.
The goal type. Can be
SAVE_AMOUNT or PAYOFF.The category of the goal (e.g.
VACATION, COLLEGE, HOUSE).The name of the goal visible to the user.
Date and time the goal was completed in ISO 8601 format.
Determines if the goal has been spent.
If the goal is complete, this field will be
true.⌘I

