Skip to content

create_project

Create a new project in a workspace.

Projects group related library objects into a shared collection. The caller is
added as the project's first member. Fails if a project with the same name already
exists in the workspace or the workspace project limit is reached. 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 to create the project in.
namerequiredstring1–∞ chars—The project's display name. Must be unique within the workspace.
descriptionstring0–1000 chars—Optional short project description.
instructionsstring0–200000 chars—Optional project instructions that guide content created within it. 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.