Skip to content

update_project

Update a project's name, description, instructions, or archive status.

Content fields (name/description/instructions) can only be changed while the project
is active — unarchive it first. To delete a project use delete_project. Requires
workspace project-edit permission.

`instructions` is deprecated: attach a skill to the project instead of writing
standing guidance here.

Parameters

ParameterTypeDefaultDescription
workspace_idrequiredstring (uuid)—The workspace the project belongs to.
project_idrequiredstring (uuid)—The project to update.
namestring1–∞ chars—New display name, if renaming.
descriptionstring0–1000 chars—New description, if changing.
instructionsstring0–200000 chars—New project instructions, if changing. Deprecated: attach a skill to the project instead. Honoured while it holds text, and read back as null once the project's instructions have been converted into a project-attached skill.
archivedboolean—Set true to archive the project, false to unarchive. Omit to leave archive status unchanged.