update_quota_values - Qobra public API documentation

Set, change or clear target values of one quota, for one or more users. Only the cells listed are written: a user or a period left out keeps its value, so this is an adjustment, never a replacement of the whole quota. Read the current values with list_quota_values first when the change is relative to them. Pass value: null to clear a cell. On a value synchronized from an integration, null cancels the manual overwrite and brings the synchronized value back instead. The call is all or nothing: an unknown user, a period not in the quota’s frequency format or a period listed twice refuses the whole call before anything is written. A call writes at most 100 values, all users together. Statements are not recalculated by this call, just as when a target is edited in the web app — they pick the new values up at the next automatic recalculation, or when someone refreshes them. The quota’s environment (live or a sandbox) is the one the quota lives in. Requires write permission on quotas. Available only where the Qobra write tools beta is enabled. Every write to the live environment is recorded in the audit trail as the Qobra MCP agent; writes to a sandbox are not audited.

Parameters

Body

string

required

Id of the quota whose targets to write — the id list_quotas returns, or the one create_quota just returned.

object[]

required

The targets to write, grouped by user. At most 100 values per call, all users together.

Show object properties

string

required

Id or email of the user, as a user reference carries them.

string

Currency of this user’s amount targets, as a code (EUR, USD…). It applies to every value this user has on the quota, not only to the ones sent here. Omit it to keep the user’s current currency; ignored on a percentage or float quota.

object[]

required

The cells to write for this user, one per period.

Show object properties

string

required

Period of the target, in the quota’s own frequency format: YYYY-MM (monthly), YYYY-QX (quarterly), YYYY-SX (semesterly) or YYYY (annually).

number

required

The target, in the unit list_quota_values returns. null clears it — on a value synchronized from an integration, null cancels the manual overwrite and brings the synchronized value back instead, since a synchronized value is never deleted.

Example

{
  "quota_id": "66a0b1c2d3e4f50012345678",
  "values": [
    {
      "user_id": "66a0b1c2d3e4f50012340001",
      "currency": "EUR",
      "values": [
        { "period": "2026-10", "value": 50000 },
        { "period": "2026-11", "value": 55000 }
      ]
    },
    {
      "user_id": "66a0b1c2d3e4f50012340002",
      "values": [{ "period": "2026-10", "value": null }]
    }
  ]
}

Response

Body

object

The quota the values were written on — the same row list_quotas returns. See list_quotas for the full field breakdown. Its views list the view ids list_quota_values takes as view_id, but not who they are shared with: each view’s access is null here. Call list_quotas when the question is who can read a view.

object[]

Every cell this call changed. A cell sent at the value it already held is not listed, so an empty list means nothing changed.

Show object properties

any

The value after this call; null when the cell was cleared.

string

Currency code of the value, only for an amount quota.

string

Deep link to open the quota in the Qobra web app.

object

Show object properties

string

What happened to the cell: created (it was empty), updated (new value), cleared (the value was removed), or overwrite_cancelled (a manual overwrite of a synchronized value was dropped, bringing the synchronized value back). One of: created, updated, cleared, overwrite_cancelled.

any

The value before this call; null when the cell was empty.

​Parameters

​Example

​Response

Parameters

Example

Response