paperclip_create_project
Create a new project with name and optional description, status, goal link, and workspace configuration.
Instructions
Create a new project. Optionally include a workspace config.
Args:
name: string — Project name (required)
description: string (optional) — Project description (markdown)
status: string (optional) — Initial status (example: "active")
goalId: string (optional) — Goal UUID to link the project
workspace.cwd: string (optional) — Local working directory (example: "/home/user/repo")
workspace.repoUrl: string (optional) — Remote repository URL (example: "https://github.com/org/repo")
Returns: Returns the created project object with all fields including assigned UUID and workspace if provided.
Examples:
Use when: setting up a new feature project linked to a goal, with a workspace for agent execution
Don't use when: you need to add a workspace to an existing project — use paperclip_create_workspace instead
Error Handling:
400: validation failure → ensure name is non-empty
401: authentication failed → check PAPERCLIP_API_KEY
404: goalId not found → verify with paperclip_list_goals
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Project name | |
| description | No | Project description (markdown) | |
| status | No | Initial status (e.g. active) | |
| goalId | No | Goal UUID to link the project to | |
| workspace | No | Optional workspace config to create alongside the project |