Skip to main content
PUT
/
budgets
/
{budget_guid}
Update a specific budget
curl --request PUT \
  --url https://int-data.moneydesktop.com/budgets/{budget_guid} \
  --header 'Content-Type: application/vnd.mx.nexus.v1+json' \
  --header 'MD-SESSION-TOKEN: <api-key>' \
  --data '
{
  "budget": [
    {
      "amount": 1000,
      "metadata": "Additional information",
      "skip_webhook": true
    }
  ]
}
'
{
  "budget": {
    "amount": 153,
    "category_guid": "CAT-bd56d35a-a9a7-6e10-66c1-5b9cc1b6c81a",
    "created_at": "2018-10-18T19:51:26.000Z",
    "guid": "BGT-6ca0e3ef-c65e-4655-8b5a-275a3c19c21d",
    "is_exceeded": true,
    "is_off_track": true,
    "metadata": "some metadata",
    "name": "Food & Dining",
    "off_track_percentage": 123,
    "parent_guid": "<string>",
    "percent_spent": 1276.34,
    "projected_spending": 3562.4,
    "revision": 561,
    "transaction_total": 1952.8,
    "updated_at": "2022-06-14T21:17:11+00:00\"",
    "user_guid": "USR-11141024-90b3-1bce-cac9-c06ced52ab4c"
  }
}

Authorizations

​
MD-SESSION-TOKEN
string
header
required

MX Session Token

  • Request an API token using the read API token endpoint in the MX SSO API.
  • Exchange an API token for a session token.
    • A session token is obtained by sending a POST request to /sessions
    • The session token will be used in each request made for the user. It should be passed in an MD-SESSION-TOKEN HTTP header as shown below.
    • This session token is valid for 30 minutes from the time it was created. The 30 minute expiration counter is refreshed with each call.
    • If you send a request with an expired session token you'll receive an error code of 4011.
curl -i https://int-data.moneydesktop.com/accounts \
-H 'MD-SESSION-TOKEN: CWforZl1Vn2vC_v6H4rnQRT1DoWpDouJAV-_5TBmiQRAtA8rsOG_BoajTiOSsL0A3bd-bmHXlA-eQzc9ywItKg' \
-H 'Content-Type: application/vnd.mx.nexus.v1+json' \
-H 'Accept: application/vnd.mx.nexus.v1+json'

In documentation code examples, replace <API_KEY_VALUE> with the session token.

Path Parameters

​
budget_guid
string
required

The unique identifier for the budget. Defined by MX.

Body

application/vnd.mx.nexus.v1+json
​
budget
object[]

Response

200 - application/vnd.mx.nexus.v1+json

OK

​
budget
object