> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qobra.co/llms.txt
> Use this file to discover all available pages before exploring further.
# update_plan
> Rename a plan, declare its whole membership in one call, or both. Missing rows are removed, so send the full set to keep.
Rename a plan, set who is attributed to it, or both in one call.
Pass at least one of `name` or `attributions` — a call with neither has
nothing to update.
`attributions` is the plan's **whole** membership, not an addition to it:
whoever the list leaves out is taken off the plan. Read the plan with
[`get_plan`](/mcp_documentation/tools/get_plan) first and send back every
membership to keep, or the ones missing from your list are removed. Omitting
the argument leaves the membership untouched, so a rename alone is safe;
passing an empty list clears the plan. Declaring a membership that already
matches changes nothing, so the same call can be sent twice.
Only what actually changed comes back in `attribution_changes`, each row
saying whether it was created, moved, or removed.
On the live environment, changing a membership triggers a statement refresh
for every user it affects — their statements move to `NEED_REFRESH` and are
recalculated in the background. A call that changes nothing triggers no
refresh, and a sandbox write causes none either.
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
Id of the plan to update — the id list\_plans returns. The plan also
decides which environment the attributions land in, so there is no
sandbox argument here.
New display name for the plan. Omit to leave the current name as it is.
Who the plan attributes, as the complete list — every user and group on
it, each with the months they are on it for. This replaces the plan's
membership rather than adding to it: anyone missing from the list is
taken off the plan. Omit the argument to leave the membership untouched;
pass an empty list to clear it. Send one row per continuous stretch,
with no month covered twice for the same user or group.
Id of the user to attribute — the id a user reference carries. Fill
this or group\_id, never both.
Id of the group to attribute — the id list\_groups returns. Fill
this or user\_id, never both.
YYYY-MM; the first month this membership covers.
YYYY-MM; the last month it covers, included. Omit it for a
membership that stays open with no end.
## Response
The plan as it now stands after the update.
Deep link to open this plan in the Qobra web app.
The section the plan is filed under; null when unfiled.
Every membership the call actually changed — created, moved, or removed
because the declared list no longer held it. Empty when the call only
renamed the plan, and empty when the declared membership already
matched what the plan had, which is how a repeated call reads as the
no-op it was.
`created` for a membership this call added; `moved` for one that
already existed and had its dates changed, the row showing the new
ones; `removed` for one the declared set no longer holds.
The attribution as it now stands — its last state before removal
for a "removed" row, since it no longer exists on the plan.
`user` for an individual attribution, `group` for a whole group
attributed at once.
The attributed user; null for group attributions.
The attributed group; null for user attributions.