Tools in this category
| Tool | Mutating | Description |
|---|---|---|
list_project_relationships |
no | List directional relationships for a project. Returns both outgoing and incoming links, each tagged with a direction. |
list_task_relationships |
no | List directional relationships for a task. Returns both outgoing and incoming links, each tagged with a direction. |
create_project_relationship |
yes | Create a directional project→project relationship by passing either typeConfigId (UUID) or typeId (slug like "blocks"); self-links are rejected. |
create_task_relationship |
yes | Create a directional task→task relationship by passing either typeConfigId (UUID) or typeId (slug like "blocks"); self-links are rejected. |
update_relationship |
yes | Update a project or task relationship by id — change the target entity and/or the relationship type (pass typeConfigId or typeId slug). Scope is resolved server-side, and self-links are rejected. |
delete_relationship |
yes | Delete a project or task relationship by id. The scope is resolved server-side. |
list_project_relationships
Mutating: no
List directional relationships for a project. Returns both outgoing and incoming links, each tagged with a direction.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
projectDisplayId |
string | yes | Project display ID (e.g. "P-7"). |
list_task_relationships
Mutating: no
List directional relationships for a task. Returns both outgoing and incoming links, each tagged with a direction.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
taskDisplayId |
string | yes | Task display ID (e.g. "T-7"). |
create_project_relationship
Mutating: yes
Create a directional project→project relationship by passing either typeConfigId (UUID) or typeId (slug like "blocks"); self-links are rejected.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
sourceProjectDisplayId |
string | yes | Source project display ID. |
targetProjectDisplayId |
string | yes | Target project display ID. |
typeConfigId |
string | no | Relationship type config UUID (alternative to typeId). |
typeId |
string | no | Slug; resolved server-side against this scope. |
create_task_relationship
Mutating: yes
Create a directional task→task relationship by passing either typeConfigId (UUID) or typeId (slug like "blocks"); self-links are rejected.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
sourceTaskDisplayId |
string | yes | Source task display ID. |
targetTaskDisplayId |
string | yes | Target task display ID. |
typeConfigId |
string | no | Relationship type config UUID (alternative to typeId). |
typeId |
string | no | Slug; resolved server-side against this scope. |
update_relationship
Mutating: yes
Update a project or task relationship by id — change the target entity and/or the relationship type (pass typeConfigId or typeId slug). Scope is resolved server-side, and self-links are rejected.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id |
string | yes | Relationship ID. |
targetDisplayId |
string | no | New target entity display ID. |
typeConfigId |
string | no | Relationship type config UUID (alternative to typeId). |
typeId |
string | no | Slug; resolved against the relationship scope. |
delete_relationship
Mutating: yes
Delete a project or task relationship by id. The scope is resolved server-side.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id |
string | yes | Relationship ID. |