feature_create
tools/call
Create a Feature at the end of a project's list, Planned unless status says otherwise. Needs Manage projects on the project.
Scopes
read:projectswrite:projectsmanage:projects
Inputs
- projectstringRequired
- Project name, key (DEV) or ID
- namestringRequired
- Feature name, at most 180 characters
- goalstring | null
- One line under the name, at most 300 characters; null clears it
- descriptionstring | null
- Markdown description, at most 20,000 characters; null clears it
- ownerstring | null
- Actor ID from people_list who can read the project, or me; null clears it
- targetDatestring | null
- Target day YYYY-MM-DD, a calendar day, not a time; null clears it
- specstring | null
- pageId of a Docs page of the same project (project_page_list) to link as the spec; null clears it
- status"planned" | "active" | "paused" | "completed" | "archived"
- icon"layers" | "rocket" | "flag" | "target" | "package" | "sparkles" | "shield" | "chart" | "puzzle" | "book" | null
- color"gray" | "orange" | "blue" | "green" | "violet" | "amber" | "pink" | "teal" | "olive" | "copper" | "indigo" | "red" | "yellow" | null
- tagsstring[]
- The complete tag names; [] clears them
- idempotencyKeystringRequired
- Unique retry key retained for 24 hours
Returns
The created Feature as feature_get answers it, and whether it was a replay. A call returns content[0].text with the JSON result and structuredContent.result with the same value.
Listed when
The key has read:projects; the tools that write need write:projects too, and the Feature writes manage:projects.