Sign in
Budgets

Update a budget

An existing budget can be updated by making a PUT request on the URL for that budget. Only the fields provided in the data block will be updated; any unspecified fields will remain unchanged.

put/budgets/{budget_gid}

Request

  • Base URL: https://app.asana.com/api/1.0
  • URL: https://app.asana.com/api/1.0/budgets/{budget_gid}
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://app.asana.com/-/oauth_authorize, token URL https://app.asana.com/-/oauth_token)

Query parameters

opt_fieldsstring[]

This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. Properties can include nested fields. To learn more, see the input/output options guide.

Request body

Example request

{
  "data": {
    "gid": "12345",
    "resource_type": "budget",
    "estimate": {
      "source": "tasks",
      "enabled": true
    },
    "actual": {
      "billable_status_filter": "billable"
    },
    "total": {
      "enabled": true,
      "value": 100
    },
    "parent": "181636"
  }
}

Response

Successfully updated the budget.

Example response

{
  "data": {
    "gid": "12345",
    "resource_type": "budget",
    "estimate": {
      "source": "tasks",
      "enabled": true,
      "units": "USD",
      "value": 100
    },
    "actual": {
      "billable_status_filter": "billable",
      "value": 100,
      "units": "USD"
    },
    "total": {
      "enabled": true,
      "value": 100,
      "units": "USD"
    },
    "parent": {
      "gid": "12345",
      "resource_type": "project",
      "name": "Stuff to buy",
      "resource_subtype": "default_project"
    }
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.