# projects operations

MCP tools and operation permissions for projects.

Generated from the shared operation catalog. Use [the JSON catalog](https://bytesmap.com/docs/reference/operations.json) for complete input schemas. Required dependency checks can be stricter than the resource permission listed below.

## project_list

List accessible projects and counts of dashboards, folders, queries, charts, actions and panels. Project grants apply to their saved items; individually shared items remain accessible without a project grant. Counts include only accessible items.

- **HTTP:** `GET /api/projects`
- **SDK:** `client.projects.list(input)`
- **Access:** workspace
- **Effect annotation:** Read-only

See the JSON schema for this input contract.

## project_create

Create a project for related dashboards, folders, queries, charts, actions and panels. Does not create an organization, duplicate resources or execute data.

- **HTTP:** `POST /api/projects`
- **SDK:** `client.projects.create(input)`
- **Access:** workspace; project / write
- **Effect annotation:** May change state or run effects

| Input | Requirement | Description |
| --- | --- | --- |
| `name` | Required | string |
| `description` | Optional | string |

## project_update

Rename a project or update its description.

- **HTTP:** `PATCH /api/projects/:id`
- **SDK:** `client.projects.update(input)`
- **Access:** workspace; project / write
- **Effect annotation:** May change state or run effects

| Input | Requirement | Description |
| --- | --- | --- |
| `name` | Required | string |
| `description` | Optional | string |
| `id` | Required | string |

## project_delete

Remove a project container. Its dashboards, folders, queries, charts, actions and panels become unassigned; definitions and references are retained. Project-inherited access ends; direct item grants remain.

- **HTTP:** `DELETE /api/projects/:id`
- **SDK:** `client.projects.remove(input)`
- **Access:** workspace; project / admin
- **Effect annotation:** May change state or run effects; destructive operation

| Input | Requirement | Description |
| --- | --- | --- |
| `id` | Required | string |

## project_assign

Move existing dashboards, folders, queries, charts, actions or panels into a project, or null for Unassigned. Moving a folder includes all its dashboards and their component views, retaining folder membership. Requires Write on each resource and the affected projects; folders also require dashboard folder management. Atomic; IDs, definitions, publications and dashboard bindings remain unchanged.

- **HTTP:** `POST /api/projects/assign`
- **SDK:** `client.projects.assign(input)`
- **Access:** workspace; project / read
- **Effect annotation:** May change state or run effects

| Input | Requirement | Description |
| --- | --- | --- |
| `projectId` | Required | See schema |
| `resources` | Required | array |