update_project
Apply a partial update to a project. Only supplied fields are touched; omitted keys stay as-is.
Apply a partial update to an existing project. Delegates to an Action so the project-service policy and cache invalidation run, and a project.updated event fires with a map of changed fields.
Requires ability
The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.
Runs the same action as
The REST endpoint and this tool share one action, so validation, permissions and events are identical.
Fires one event
Delivered to every endpoint subscribed to it once the change is made.
Annotations
A client that honours annotations asks a person before running it. Sending the same arguments twice changes nothing the second time. It reaches beyond Subscriby: a connector, a provider or a member.
Arguments
project_id*stringUUID of the project to update.
namestringoptionalNew project name (min 5, max 255 chars).
descriptionstringoptionalNew description. Max 1000 chars, HTML is filtered.
handlestringoptionalNew URL-friendly handle. Alpha-dash lowercase, 5-255 chars, unique. Requires Starter or Growth creator tier.
termsstringoptionalURL to the terms page. Max 255 chars.
privacystringoptionalURL to the privacy page. Max 255 chars.
metricsbooleanoptionalToggle aggregated metrics collection.
activebooleanoptionalFlip to false to archive, true to restore.
outage_compensationsbooleanoptionalWhether members whose paid access overlapped a connector outage of an hour or more have it extended by the outage length when the connector answers again. Defaults to true on every project.
team_idstringoptionalUUID of the owning team.
What it returns
{ "data": { "id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13", "name": "Research Premium", "handle": "research-premium", "active": true }}How it fails
RESOURCE_NOT_FOUNDunknown project_id, or the project belongs to a team outside the token's scope.
VALIDATION_FAILEDa malformed field, or team_id is a team the token's owner does not belong to.
TOKEN_MISSING_ABILITYtoken lacks project:update.
How is this guide?
Last updated on