Projects

Update project

Renames a project. This endpoint does not create, delete or reconfigure projects.

  • Only name is writable: a non-empty string of at most 191 characters.
  • Unknown fields are rejected with 400 INVALID_PARAMS rather than silently ignored.
  • Send expectedUpdatedAt (the revision from GET) to fence the rename: if the project changed since that read, the call returns 409 STALE_PROJECT instead of overwriting a newer name. Shop API keys may omit it; delegated (MCP OAuth) tokens must send it or get 428 PRECONDITION_REQUIRED.
  • Hierarchy, shop linkage and market settings belong to Studio and the Dashboard and are not writable with an API key.
  • No cache invalidation happens: name does not affect rendered storefront content.
  • Clients or proxies that cannot send PATCH may send POST to the same URL with the same body.

Required scope: content:write

patch/projects/{projectId}

Request

  • Base URL
    https://studio.weaverse.io/api/v1/content
  • Auth
    HTTP bearer

Path parameters

projectIdstring required

Request body

namestring required

New project name.

expectedUpdatedAtstring date-time

The project revision from your last GET, sent back unchanged. When it no longer matches, the rename is refused with 409 STALE_PROJECT. Optional for shop API keys; required for delegated (MCP OAuth) tokens, which get 428 PRECONDITION_REQUIRED without it.

Response

The updated project

object'project'
idstring
namestring nullable
parentProjectIdstring nullable
createdAtstring date-time nullable
revisionstring date-time nullable

The project's revision (its updatedAt). Send it back as expectedUpdatedAt on project-fenced writes such as a rename.

Changes

No recorded changes to this operation across all 1 revision of this API.