Tools in this category
| Tool | Mutating | Description |
|---|---|---|
list_project_relationship_types |
no | List the user's project relationship type configurations. Use the returned id (or typeId slug) when creating a relationship between two projects. |
list_task_relationship_types |
no | List the user's task relationship type configurations. Use the returned id (or typeId slug) when creating a relationship between two tasks. |
get_relationship_type |
no | Fetch a single relationship type config (project or task scope) including slug, display name, color, and enabled state. |
create_project_relationship_type |
yes | Create a new project relationship type. typeId is auto-generated from name if omitted. |
create_task_relationship_type |
yes | Create a new task relationship type. typeId is auto-generated from name if omitted. |
update_relationship_type |
yes | Update an existing relationship type. Only supplied fields change; the slug is immutable. |
delete_relationship_type |
yes | Delete a relationship type. Fails if any relationships still use it — update those relationships to a different type via update_relationship first. |
list_project_relationship_types
Mutating: no
List the user's project relationship type configurations. Use the returned id (or typeId slug) when creating a relationship between two projects.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
enabledOnly |
boolean | no | When true, only enabled types are returned (default false). |
list_task_relationship_types
Mutating: no
List the user's task relationship type configurations. Use the returned id (or typeId slug) when creating a relationship between two tasks.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
enabledOnly |
boolean | no | When true, only enabled types are returned (default false). |
get_relationship_type
Mutating: no
Fetch a single relationship type config (project or task scope) including slug, display name, color, and enabled state.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id |
string | yes | Relationship type config ID. |
create_project_relationship_type
Mutating: yes
Create a new project relationship type. typeId is auto-generated from name if omitted.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
typeId |
string | no | Stable slug (e.g. "blocks"). Auto-generated from name if omitted. |
name |
string | yes | Display name |
description |
string | no | Free-form description shown in pickers. |
color |
string | no | Color token or hex |
enabled |
boolean | no | Whether the type is selectable in pickers; defaults to true. |
order |
integer | no | Sort order. |
affectsTarget |
boolean | no | When true, the source affects the target: the target is highlighted on the kanban while the source is unfinished. Defaults to false. |
affectedByTarget |
boolean | no | When true, the source is affected by the target: the source is highlighted on the kanban while the target is unfinished. Defaults to false. |
create_task_relationship_type
Mutating: yes
Create a new task relationship type. typeId is auto-generated from name if omitted.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
typeId |
string | no | Stable slug (e.g. "blocks"). Auto-generated from name if omitted. |
name |
string | yes | Display name |
description |
string | no | Free-form description shown in pickers. |
color |
string | no | Color token or hex |
enabled |
boolean | no | Whether the type is selectable in pickers; defaults to true. |
order |
integer | no | Sort order. |
affectsTarget |
boolean | no | When true, the source affects the target: the target is highlighted on the kanban while the source is unfinished. Defaults to false. |
affectedByTarget |
boolean | no | When true, the source is affected by the target: the source is highlighted on the kanban while the target is unfinished. Defaults to false. |
update_relationship_type
Mutating: yes
Update an existing relationship type. Only supplied fields change; the slug is immutable.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id |
string | yes | Relationship type config ID. |
typeId |
string | no | Stable slug (e.g. "blocks"). Auto-generated from name if omitted. |
name |
string | no | Display name |
description |
string | no | Free-form description shown in pickers. |
color |
string | no | Color token or hex |
enabled |
boolean | no | Whether the type is selectable in pickers; defaults to true. |
order |
integer | no | Sort order. |
affectsTarget |
boolean | no | When true, the source affects the target: the target is highlighted on the kanban while the source is unfinished. Defaults to false. |
affectedByTarget |
boolean | no | When true, the source is affected by the target: the source is highlighted on the kanban while the target is unfinished. Defaults to false. |
delete_relationship_type
Mutating: yes
Delete a relationship type. Fails if any relationships still use it — update those relationships to a different type via update_relationship first.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id |
string | yes | Relationship type config ID. |