Projects
Manage projects, their settings, and lifecycle.
7 tools
# list_projects
List projects in the workspace. Active-only by default; pass include_archived=true to also return archived (read-only) projects.
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| include_archived | boolean | — | Include archived (read-only) projects in the result |
# get_project
Get a project by ID or slug
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| project_id | string | ● | Project ID or slug |
# create_project
Create a new project
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| name | string | ● | Project name |
| key | string | ● | Short key (e.g. KERA) |
| lead_email | string | — | Project lead email |
| template | string | — | Template source (e.g. builtin:default, git:software-dev). Defaults to builtin:default. |
# update_project
Update a project's name, lead, or status
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| project_id | string | ● | Project ID |
| name | string | — | New name |
| lead_email | string | — | New lead email |
| status | string | — | active|archived |
# list_project_groups
List the groups that have access to a project, with member counts. Members of an assigned group can edit and comment in the project
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| project_id | string | ● | Project ID |
# assign_project_group
Give a group access to a project. Project lead or admin only
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| project_id | string | ● | Project ID |
| group_id | string | ● | Group ID (UUID) |
# remove_project_group
Remove a group's access to a project. Project lead or admin only
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| project_id | string | ● | Project ID |
| group_id | string | ● | Group ID (UUID) |