---
title: Build on Venom Tasks
description: Create, find and update Tasks issues from code, and run agents that claim delegated work, report progress and hand it back, over REST or MCP.
section: developers
order: 20
audience: [builder, agent]
sources: [services/nodejs-cloud/lib/tasks/mcp, services/nodejs-cloud/lib/tasks/mcp/bridge-ops.ts, services/nodejs-cloud/lib/tasks/agents.ts, services/nodejs-cloud/lib/tasks/assigned.ts, services/nodejs-cloud/app/tasks/mcp, services/nodejs-cloud/lib/mcp/workspace.ts, services/nodejs-cloud/lib/mcp/rest.ts, services/nodejs-cloud/lib/mcp/limits.ts]
features: []
---

Venom Tasks is your organisation's issue tracker. An issue has a person as its assignee, who owns it, and can be
delegated to an agent, which does the work. Every action of the Tasks app is an MCP tool and a REST route, so a script
can file issues and an agent can pick up work, claim it, report progress and move it to review.

## What you can build {#build}

- **An agent worker.** List the issues delegated to it (`GET /api/v1/issues/mine`), claim one
  (`POST /api/v1/issues/{id}/claim`), report progress and move it to review (`POST /api/v1/issues/{id}/progress`).
- **Issues from other systems.** File an issue from a failed job or a support ticket (`POST /api/v1/issues`) with a
  team, labels, a priority and a delegate.
- **Bulk changes.** Relabel, move or reprioritise up to 50 issues in one call, all or nothing
  (`POST /api/v1/tasks/issues/batch`).
- **Planning reports.** Read cycles, projects and their milestones (`GET /api/v1/tasks/teams/{id}/cycles`,
  `GET /api/v1/tasks/projects`) and the team insights (`GET /api/v1/tasks/insights`).
- **A push-driven worker.** Hold `GET /tasks/mcp/assigned` open and start work within seconds of an issue being
  delegated, with no polling.

## At a glance {#glance}

Generated from the code on every docs build.

| | |
|---|---|
| MCP endpoint | `https://cloud.usevenom.dev/workspace/mcp/tasks`, server name `venom-tasks` |
| Connect | `claude mcp add --transport http venom-tasks https://cloud.usevenom.dev/workspace/mcp/tasks` |
| MCP tools | 221 (81 read, 140 write) |
| OAuth scopes | `tasks:read` `tasks:write` |
| REST twin | 228 routes under `https://cloud.usevenom.dev/api/v1` |
| Webhook events | `tasks.issue.created`, `tasks.issue.updated`, `tasks.issue.deleted`, `tasks.comment.created`, `tasks.issue.delegated` |

## Authentication and scopes {#scopes}

Every credential becomes an agent with an id, and that id is what issues are delegated to and what comments record:

| Credential | Agent | What it may do |
|---|---|---|
| Personal API key | `key:<key id>`, a personal agent for its member | what the member's role allows |
| OAuth app | a personal agent for the member who connected it | the member's role, narrowed by `tasks:read` and `tasks:write` |
| Team key bound to a service agent | the service agent | read and write in the teams the admin picked; read only if the admin made it read-only |
| Team key with no service agent | none | read only, and it cannot claim |
| Any key with `x-venom-agent: daemon:<uuid>` or `session:<id>` | that venom daemon or session | what the key allows |

The member's role sets the ceiling: owners and admins have `tasks:read`, `tasks:write` and `tasks:admin`; developers
read and write; billing and viewer members read only. Team settings, workflow states and agents need `tasks:admin`. A
read-only caller is refused every write with a message that says why. A private team's issues answer as if they did
not exist for anyone who is not in the team and has no `tasks:admin`.

An admin binds a team key to a service agent with `tasks_agent_create` (or `POST /api/v1/tasks/agents`), and can
limit it to some teams, some apps or read only with `tasks_agent_update`. A service agent limited to some teams sees
only those teams' issues.

Tasks is included in the Team plan and up. Without it, the handshake still works and every tool answers with a message
that says where to add it; over REST that is `403 forbidden`.

## Worked example {#example}

An agent's loop: find work, claim it, report, and hand it to review.

```bash
# 1. The open issues delegated to this agent, and those assigned to its member
curl "$VENOM_CLOUD/api/v1/issues/mine?limit=10" \
  -H "Authorization: Bearer $VENOM_API_KEY"

# 2. Claim one: it is delegated to you and moved to the team's first started state
curl -X POST "$VENOM_CLOUD/api/v1/issues/ENG-42/claim" \
  -H "Authorization: Bearer $VENOM_API_KEY" -H 'Content-Type: application/json' -d '{}'

# 3. Report progress, and move it to review when done
curl -X POST "$VENOM_CLOUD/api/v1/issues/ENG-42/progress" \
  -H "Authorization: Bearer $VENOM_API_KEY" -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: eng-42-review' \
  -d '{"body": "Fix pushed and tests pass. Ready for review.", "state": "In Review"}'
```

The same claim and report over MCP, from any client connected to `/workspace/mcp/tasks`:

```json
{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "tasks_issue_claim", "arguments": { "id": "ENG-42" } } }
```

```json
{ "jsonrpc": "2.0", "id": 2, "method": "tools/call",
  "params": { "name": "tasks_issue_progress",
              "arguments": { "id": "ENG-42", "body": "Fix pushed and tests pass. Ready for review.", "state": "In Review" } } }
```

`id` is the issue's identifier (`ENG-42`) or its id. `state` is a workflow state of the issue's team by name, or a type:
`backlog`, `unstarted`, `started`, `completed`, `canceled`, `triage`.

## Claims and leases {#claims}

- A claim is a **30-minute lease**. While it is live, another agent's claim is refused and the message names the
  holder and when the lease ends (`403` over REST).
- Each write by the agent holding the claim renews the lease, so report progress at least every 30 minutes.
- When a lease runs out, the claim is cleared but the delegate stays, and the issue's assignee (its creator when
  nobody is assigned) gets a "claim expired" item in their Inbox.
- Claiming never changes the assignee. Set `delegate` and `assignee` apart with `PATCH /api/v1/issues/{id}`.
- A closed issue cannot be claimed; reopen it with a `state` first.
- A service agent's guidance, set by an admin, is shown at the end of `tasks_issue_get`.

## Push: issues delegated to you {#push}

`GET /tasks/mcp/assigned` is a server-sent event stream for one agent, with the same credentials as the MCP endpoint.
It needs an agent, so a team key with no service agent gets `403`. It sends an `assigned` event for each open issue
delegated to the agent that has no live claim, first the ones already delegated and then each new delegation:

```text
id: 4121
event: assigned
data: {"seq":4121,"issueId":"…","identifier":"ENG-42","title":"…","teamId":"…","stateType":"unstarted","priority":1}
```

Reconnect with `Last-Event-ID` (or `?after=`) to skip what you have seen. The stream pings every 25 seconds and closes
after about 4.5 minutes; reconnect. Each connection counts as one request in the agent's rate limit.

## Limits {#limits}

- 240 requests a minute per agent, and 960 per credential over all its agents, then `429` with `retry-after`.
- 1 MiB per request; a comment is at most 64 KB.
- A write that contains a credential is refused before anything is stored.
- Every write is recorded in the organisation's audit log under the credential and agent, with ids, never the text.

Venom Tasks' own MCP endpoint, `POST /tasks/mcp`, serves the same tools; `/workspace/mcp/tasks` shares one credential
with the other products. Setup for clients is in [Venom Tasks for agents](/docs/cloud/tasks-mcp.md).

## Events {#events}

5 org webhook events, generated from `lib/webhooks/events.ts`. Subscribe an endpoint to them in Settings, Webhooks (see [Webhooks and events](/docs/developers/webhooks)).

| Event | When |
|---|---|
| `tasks.issue.created` | A Venom Tasks issue was created, by a person or an agent: identifier, title, team, state, priority, assignee and delegate. Never the description. |
| `tasks.issue.updated` | A Venom Tasks issue changed: its state, assignee, delegate (and whether an agent holds a claim on it), priority, labels or text. Several changes within a minute arrive as one event with the issue as it is now. |
| `tasks.issue.deleted` | A Venom Tasks issue was deleted: its id and identifier. |
| `tasks.comment.created` | A comment was added to a Venom Tasks issue, by a person or an agent's progress report: the issue, the comment id and who wrote it. Never the comment's text. |
| `tasks.issue.delegated` | A Venom Tasks issue was delegated to an agent (at creation or later, each new delegate): the issue, its identifier and title, the delegate agent's id, the previous delegate and who delegated it, so an agent learns of new work without holding a stream open. Never the description. |

Besides org webhooks, an agent can follow its own work on the `GET /tasks/mcp/assigned` stream above, and any caller
can poll `GET /api/v1/changes` for issue and note changes after a cursor. GitHub sends its webhooks into Tasks to link
pull requests and turn labelled GitHub issues into delegated work
([GitHub issues as intents](/docs/cloud/tasks-github.md#intents)).

## REST routes {#rest}

The REST twin: 228 routes under `https://cloud.usevenom.dev/api/v1`, each calling the MCP tool named in its row with the same arguments (see [the REST twin](/docs/developers/rest)).

**/teams**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | `/api/v1/teams` | List the teams you can see, with their states | `tasks_team_list` |

**/issues**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | `/api/v1/issues` | Find issues by text and filters (filter: the list's JSON filter tree) | `tasks_issue_search` |
| POST | `/api/v1/issues` | Create an issue | `tasks_issue_create` |
| GET | `/api/v1/issues/mine` | List the issues delegated to this agent and assigned to its member | `tasks_issue_list_mine` |
| GET | `/api/v1/issues/{id}` | Read one issue | `tasks_issue_get` |
| PATCH | `/api/v1/issues/{id}` | Change an issue; edits patch its description | `tasks_issue_update` |
| POST | `/api/v1/issues/{id}/comments` | Comment on an issue | `tasks_comment_create` |
| POST | `/api/v1/issues/{id}/claim` | Claim an issue with a 30-minute lease | `tasks_issue_claim` |
| POST | `/api/v1/issues/{id}/progress` | Post a progress comment, optionally moving the state | `tasks_issue_progress` |

**/tasks/issues**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| POST | `/api/v1/tasks/issues/batch` | Change many issues at once | `tasks_issue_batch` |
| POST | `/api/v1/tasks/issues/move` | Move issues to another team | `tasks_issue_move` |
| DELETE | `/api/v1/tasks/issues/{id}` | Delete an issue | `tasks_issue_delete` |
| GET | `/api/v1/tasks/issues/{id}/history` | List an issue's description versions | `tasks_issue_history` |
| POST | `/api/v1/tasks/issues/{id}/history/{version_id}/restore` | Restore an earlier description | `tasks_issue_revert` |
| POST | `/api/v1/tasks/issues/{id}/subscribe` | Subscribe to an issue | `tasks_issue_subscribe` |
| DELETE | `/api/v1/tasks/issues/{id}/subscribe` | Unsubscribe from an issue | `tasks_issue_unsubscribe` |
| POST | `/api/v1/tasks/issues/{id}/triage` | Triage an issue | `tasks_issue_triage` |
| GET | `/api/v1/tasks/issues/{id}/activity` | List an issue's activity | `tasks_activity_list` |
| POST | `/api/v1/tasks/issues/{id}/relations` | Relate two issues | `tasks_relation_create` |
| POST | `/api/v1/tasks/issues/{id}/duplicate` | Make a copy of an issue | `tasks_issue_duplicate` |
| POST | `/api/v1/tasks/issues/{id}/convert-to-project` | Convert an issue to a project | `tasks_issue_convert_to_project` |
| GET | `/api/v1/tasks/issues/{id}/comments` | List an issue's comments | `tasks_comment_list` |
| POST | `/api/v1/tasks/issues/{issue_id}/reactions` | React with an emoji | `tasks_reaction_add` |
| DELETE | `/api/v1/tasks/issues/{issue_id}/reactions` | Remove a reaction | `tasks_reaction_remove` |
| GET | `/api/v1/tasks/issues/{id}/attachments` | List an issue's attachments | `tasks_attachment_list` |
| POST | `/api/v1/tasks/issues/{id}/attachments` | Attach a file to an issue | `tasks_attachment_create` |
| GET | `/api/v1/tasks/issues/{id}/links` | List an issue's links | `tasks_link_list` |
| POST | `/api/v1/tasks/issues/{id}/links` | Add a link to an issue | `tasks_link_create` |
| GET | `/api/v1/tasks/issues/{id}/requests` | List an issue's customer requests | `tasks_request_list` |
| POST | `/api/v1/tasks/issues/{id}/requests` | Add a customer request to an issue | `tasks_request_create` |
| GET | `/api/v1/tasks/issues/{id}/notes` | List an issue's linked notes | `tasks_note_list` |
| POST | `/api/v1/tasks/issues/{id}/notes` | Link or create a note for an issue | `tasks_note_link` |
| DELETE | `/api/v1/tasks/issues/{id}/notes` | Unlink a note from an issue | `tasks_note_unlink` |
| GET | `/api/v1/tasks/issues/{id}/pull-requests` | List an issue's pull requests | `tasks_pullrequest_list` |
| POST | `/api/v1/tasks/issues/{id}/pull-requests` | Refresh an issue's pull requests | `tasks_pullrequest_link` |
| DELETE | `/api/v1/tasks/issues/{id}/pull-requests/{pr_id}` | Unlink a pull request from an issue | `tasks_pullrequest_unlink` |
| GET | `/api/v1/tasks/issues/{id}/suggestions` | List AI suggestions for an issue | `tasks_suggestion_list` |
| POST | `/api/v1/tasks/issues/{id}/suggestions` | Ask for AI suggestions | `tasks_suggestion_create` |
| POST | `/api/v1/tasks/issues/{id}/apply-template` | Apply a template to an issue | `tasks_template_apply` |
| GET | `/api/v1/tasks/issues/export` | Export a list of issues as CSV | `tasks_issue_export` |

**/tasks/relations**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| DELETE | `/api/v1/tasks/relations/{id}` | Remove an issue relation | `tasks_relation_delete` |

**/tasks/dependencies**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | `/api/v1/tasks/dependencies` | List issue dependencies | `tasks_dependency_list` |

**/tasks/insights**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | `/api/v1/tasks/insights` | Read Tasks insights | `tasks_insight_get` |
| GET | `/api/v1/tasks/insights/flow` | Read a cumulative flow | `tasks_flow_insight_get` |

**/tasks/projects**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | `/api/v1/tasks/projects/{id}/insights` | Read a project's insights | `tasks_project_insight_get` |
| POST | `/api/v1/tasks/projects/{id}/follow` | Follow a project | `tasks_project_follow` |
| DELETE | `/api/v1/tasks/projects/{id}/follow` | Unfollow a project | `tasks_project_unfollow` |
| GET | `/api/v1/tasks/projects/{id}/requests` | List a project's customer requests | `tasks_projectrequest_list` |
| POST | `/api/v1/tasks/projects/{id}/requests` | Add a customer request to a project | `tasks_projectrequest_create` |
| GET | `/api/v1/tasks/projects` | List projects | `tasks_project_list` |
| POST | `/api/v1/tasks/projects` | Create a project | `tasks_project_create` |
| GET | `/api/v1/tasks/projects/{id}` | Read a project | `tasks_project_get` |
| PATCH | `/api/v1/tasks/projects/{id}` | Change a project | `tasks_project_update` |
| DELETE | `/api/v1/tasks/projects/{id}` | Delete a project | `tasks_project_delete` |
| POST | `/api/v1/tasks/projects/{id}/move` | Move a project to another team | `tasks_project_move` |
| GET | `/api/v1/tasks/projects/{id}/activity` | List a project's activity | `tasks_project_activity` |
| GET | `/api/v1/tasks/projects/{project_id}/milestones` | List milestones | `tasks_milestone_list` |
| POST | `/api/v1/tasks/projects/{project_id}/milestones` | Add a milestone | `tasks_milestone_create` |
| GET | `/api/v1/tasks/projects/{id}/updates` | List a project's status updates | `tasks_projectupdate_list` |
| POST | `/api/v1/tasks/projects/{id}/updates` | Post a project status update | `tasks_projectupdate_create` |
| GET | `/api/v1/tasks/projects/{project}/dependencies` | List project dependencies | `tasks_projectdep_list` |
| POST | `/api/v1/tasks/projects/{project}/dependencies` | Add a project dependency | `tasks_projectdep_add` |
| DELETE | `/api/v1/tasks/projects/{project}/dependencies` | Remove a project dependency | `tasks_projectdep_remove` |
| GET | `/api/v1/tasks/projects/dependencies` | List project dependencies | `tasks_projectdep_list` |
| GET | `/api/v1/tasks/projects/{id}/links` | List a project's links | `tasks_projectlink_list` |
| POST | `/api/v1/tasks/projects/{id}/links` | Add a link to a project | `tasks_projectlink_create` |
| GET | `/api/v1/tasks/projects/{id}/documents` | List a project's documents | `tasks_document_list` |
| POST | `/api/v1/tasks/projects/{id}/documents` | Add a document to a project | `tasks_document_link` |
| DELETE | `/api/v1/tasks/projects/{id}/documents` | Remove a document from a project | `tasks_document_unlink` |
| GET | `/api/v1/tasks/projects/export` | Export projects as CSV | `tasks_project_export` |

**/tasks/cycles**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | `/api/v1/tasks/cycles/{id}/insights` | Read a cycle's insights | `tasks_cycle_insight_get` |
| GET | `/api/v1/tasks/cycles/{id}` | Read a cycle | `tasks_cycle_get` |
| PATCH | `/api/v1/tasks/cycles/{id}` | Change a cycle | `tasks_cycle_update` |
| DELETE | `/api/v1/tasks/cycles/{id}` | Delete a cycle | `tasks_cycle_delete` |
| POST | `/api/v1/tasks/cycles/{id}/start` | Start the next cycle today | `tasks_cycle_start` |
| POST | `/api/v1/tasks/cycles/{id}/complete` | Complete a cycle | `tasks_cycle_complete` |

**/tasks/saved-insights**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | `/api/v1/tasks/saved-insights` | List saved insights | `tasks_saved_insight_list` |
| POST | `/api/v1/tasks/saved-insights` | Save an insight | `tasks_saved_insight_create` |
| GET | `/api/v1/tasks/saved-insights/{id}` | Read a saved insight | `tasks_saved_insight_get` |
| PATCH | `/api/v1/tasks/saved-insights/{id}` | Change a saved insight | `tasks_saved_insight_update` |
| DELETE | `/api/v1/tasks/saved-insights/{id}` | Delete a saved insight | `tasks_saved_insight_delete` |
| GET | `/api/v1/tasks/saved-insights/{id}/result` | Run a saved insight | `tasks_saved_insight_run` |

**/tasks/reminders**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | `/api/v1/tasks/reminders` | List your reminders | `tasks_reminder_list` |
| PUT | `/api/v1/tasks/reminders` | Set a reminder | `tasks_reminder_set` |
| DELETE | `/api/v1/tasks/reminders/{id}` | Cancel a reminder | `tasks_reminder_delete` |

**/tasks/pulse**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | `/api/v1/tasks/pulse` | Read your Pulse | `tasks_pulse_get` |
| GET | `/api/v1/tasks/pulse/follows` | List what is in your Pulse | `tasks_follow_list` |
| GET | `/api/v1/tasks/pulse/digests` | List your weekly Pulse digests | `tasks_pulse_digest_list` |
| POST | `/api/v1/tasks/pulse/digests` | Make last week's Pulse digest | `tasks_pulse_digest_create` |
| GET | `/api/v1/tasks/pulse/digests/{id}` | Read a Pulse digest | `tasks_pulse_digest_get` |
| PATCH | `/api/v1/tasks/pulse/digests/{id}` | Mark a Pulse digest read | `tasks_pulse_digest_update` |
| GET | `/api/v1/tasks/pulse/settings` | Read the org's Pulse settings | `tasks_pulse_settings_get` |
| PUT | `/api/v1/tasks/pulse/settings` | Change the org's Pulse settings | `tasks_pulse_settings_update` |

**/tasks/initiatives**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| POST | `/api/v1/tasks/initiatives/{id}/follow` | Follow an initiative | `tasks_initiative_follow` |
| DELETE | `/api/v1/tasks/initiatives/{id}/follow` | Unfollow an initiative | `tasks_initiative_unfollow` |
| GET | `/api/v1/tasks/initiatives` | List initiatives | `tasks_initiative_list` |
| POST | `/api/v1/tasks/initiatives` | Create an initiative | `tasks_initiative_create` |
| GET | `/api/v1/tasks/initiatives/{id}` | Read an initiative | `tasks_initiative_get` |
| PATCH | `/api/v1/tasks/initiatives/{id}` | Change an initiative | `tasks_initiative_update` |
| DELETE | `/api/v1/tasks/initiatives/{id}` | Delete an initiative | `tasks_initiative_delete` |
| GET | `/api/v1/tasks/initiatives/{id}/updates` | List an initiative's status updates | `tasks_initiative_update_list` |
| POST | `/api/v1/tasks/initiatives/{id}/updates` | Post an initiative status update | `tasks_initiative_update_create` |
| GET | `/api/v1/tasks/initiatives/export` | Export initiatives as CSV | `tasks_initiative_export` |

**/tasks/comments**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| PATCH | `/api/v1/tasks/comments/{id}` | Edit a comment | `tasks_comment_update` |
| DELETE | `/api/v1/tasks/comments/{id}` | Delete a comment | `tasks_comment_delete` |
| PUT | `/api/v1/tasks/comments/{comment}/mute` | Mute or unmute a comment thread | `tasks_thread_mute` |
| POST | `/api/v1/tasks/comments/{comment_id}/reactions` | React with an emoji | `tasks_reaction_add` |
| DELETE | `/api/v1/tasks/comments/{comment_id}/reactions` | Remove a reaction | `tasks_reaction_remove` |

**/tasks/attachments**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| DELETE | `/api/v1/tasks/attachments/{id}` | Remove an attachment | `tasks_attachment_delete` |

**/tasks/links**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| PATCH | `/api/v1/tasks/links/{id}` | Edit a link | `tasks_link_update` |
| DELETE | `/api/v1/tasks/links/{id}` | Remove a link | `tasks_link_delete` |

**/tasks/requests**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| PATCH | `/api/v1/tasks/requests/{id}` | Change a customer request's quote | `tasks_request_update` |
| DELETE | `/api/v1/tasks/requests/{id}` | Remove a customer request | `tasks_request_delete` |
| GET | `/api/v1/tasks/requests/sources` | Find customers to link as requests | `tasks_customer_search` |

**/tasks/suggestions**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| POST | `/api/v1/tasks/suggestions/{id}` | Accept or dismiss a suggestion | `tasks_suggestion_decide` |

**/tasks/teams**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| POST | `/api/v1/tasks/teams` | Create a team | `tasks_team_create` |
| PATCH | `/api/v1/tasks/teams/{id}` | Change a team | `tasks_team_update` |
| DELETE | `/api/v1/tasks/teams/{id}` | Delete a team | `tasks_team_delete` |
| GET | `/api/v1/tasks/teams/{id}/members` | List a team's members | `tasks_teammember_list` |
| POST | `/api/v1/tasks/teams/{id}/members` | Add a member to a team | `tasks_teammember_add` |
| DELETE | `/api/v1/tasks/teams/{id}/members/{member_id}` | Remove a member from a team | `tasks_teammember_remove` |
| GET | `/api/v1/tasks/teams/{id}/states` | List a team's workflow states | `tasks_state_list` |
| POST | `/api/v1/tasks/teams/{id}/states` | Add a workflow state | `tasks_state_create` |
| POST | `/api/v1/tasks/teams/{id}/states/reorder` | Reorder workflow states | `tasks_state_reorder` |
| GET | `/api/v1/tasks/teams/{id}/templates` | List issue templates | `tasks_template_list` |
| POST | `/api/v1/tasks/teams/{id}/templates` | Create an issue template | `tasks_template_create` |
| GET | `/api/v1/tasks/teams/{id}/recurring` | List a team's recurring issues | `tasks_recurring_list` |
| POST | `/api/v1/tasks/teams/{id}/recurring` | Create a recurring issue | `tasks_recurring_create` |
| GET | `/api/v1/tasks/teams/{id}/sla` | Read a team's SLA rules | `tasks_sla_get` |
| PUT | `/api/v1/tasks/teams/{id}/sla` | Set a team's SLA rules | `tasks_sla_set` |
| GET | `/api/v1/tasks/teams/{id}/triage-rules` | List a team's triage rules | `tasks_triagerule_list` |
| POST | `/api/v1/tasks/teams/{id}/triage-rules` | Create a triage rule | `tasks_triagerule_create` |
| POST | `/api/v1/tasks/teams/{id}/triage-rules/reorder` | Reorder a team's triage rules | `tasks_triagerule_reorder` |
| POST | `/api/v1/tasks/teams/{id}/triage-rules/test` | Try a triage rule | `tasks_triagerule_test` |
| GET | `/api/v1/tasks/teams/{id}/ai-triage` | Read a team's AI triage settings | `tasks_triage_get` |
| PUT | `/api/v1/tasks/teams/{id}/ai-triage` | Set a team's AI triage settings | `tasks_triage_set` |
| GET | `/api/v1/tasks/teams/{id}/cycles` | List a team's cycles | `tasks_cycle_list` |
| POST | `/api/v1/tasks/teams/{id}/cycles` | Create a cycle | `tasks_cycle_create` |
| POST | `/api/v1/tasks/teams/{id}/cycles/schedule` | Schedule upcoming cycles | `tasks_cycle_schedule` |

**/tasks/members**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | `/api/v1/tasks/members` | List the organisation's members | `tasks_member_list` |
| GET | `/api/v1/tasks/members/export` | Export members as CSV | `tasks_member_export` |

**/tasks/states**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| PATCH | `/api/v1/tasks/states/{id}` | Change a workflow state | `tasks_state_update` |
| DELETE | `/api/v1/tasks/states/{id}` | Delete a workflow state | `tasks_state_delete` |

**/tasks/labels**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | `/api/v1/tasks/labels` | List labels | `tasks_label_list` |
| POST | `/api/v1/tasks/labels` | Create a label | `tasks_label_create` |
| PATCH | `/api/v1/tasks/labels/{id}` | Change a label | `tasks_label_update` |
| DELETE | `/api/v1/tasks/labels/{id}` | Delete a label | `tasks_label_delete` |

**/tasks/label-groups**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | `/api/v1/tasks/label-groups` | List label groups | `tasks_labelgroup_list` |
| POST | `/api/v1/tasks/label-groups` | Create a label group | `tasks_labelgroup_create` |
| PATCH | `/api/v1/tasks/label-groups/{id}` | Change a label group | `tasks_labelgroup_update` |
| DELETE | `/api/v1/tasks/label-groups/{id}` | Delete a label group | `tasks_labelgroup_delete` |

**/tasks/templates**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | `/api/v1/tasks/templates` | List issue templates | `tasks_template_list` |
| POST | `/api/v1/tasks/templates` | Create an issue template | `tasks_template_create` |
| GET | `/api/v1/tasks/templates/{id}` | Read an issue template | `tasks_template_get` |
| PATCH | `/api/v1/tasks/templates/{id}` | Change an issue template | `tasks_template_update` |
| DELETE | `/api/v1/tasks/templates/{id}` | Delete an issue template | `tasks_template_delete` |

**/tasks/recurring**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | `/api/v1/tasks/recurring/{id}` | Read a recurring issue | `tasks_recurring_get` |
| PATCH | `/api/v1/tasks/recurring/{id}` | Change a recurring issue | `tasks_recurring_update` |
| DELETE | `/api/v1/tasks/recurring/{id}` | Delete a recurring issue | `tasks_recurring_delete` |

**/tasks/triage-rules**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | `/api/v1/tasks/triage-rules/{id}` | Read a triage rule | `tasks_triagerule_get` |
| PATCH | `/api/v1/tasks/triage-rules/{id}` | Change a triage rule | `tasks_triagerule_update` |
| DELETE | `/api/v1/tasks/triage-rules/{id}` | Delete a triage rule | `tasks_triagerule_delete` |

**/tasks/milestones**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | `/api/v1/tasks/milestones` | List milestones | `tasks_milestone_list` |
| PATCH | `/api/v1/tasks/milestones/{id}` | Change a milestone | `tasks_milestone_update` |
| DELETE | `/api/v1/tasks/milestones/{id}` | Delete a milestone | `tasks_milestone_delete` |

**/tasks/project-updates**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| PATCH | `/api/v1/tasks/project-updates/{id}` | Edit a project status update | `tasks_projectupdate_update` |
| DELETE | `/api/v1/tasks/project-updates/{id}` | Delete a project status update | `tasks_projectupdate_delete` |

**/tasks/updates**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | `/api/v1/tasks/updates/{update_kind}/{update_id}/comments` | List comments on an update | `tasks_updatecomment_list` |
| POST | `/api/v1/tasks/updates/{update_kind}/{update_id}/comments` | Comment on an update | `tasks_updatecomment_create` |
| PUT | `/api/v1/tasks/updates/{update_kind}/{update_id}/reactions` | React to an update | `tasks_updatereaction_set` |

**/tasks/update-comments**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| PATCH | `/api/v1/tasks/update-comments/{id}` | Edit a comment on an update | `tasks_updatecomment_update` |
| DELETE | `/api/v1/tasks/update-comments/{id}` | Delete a comment on an update | `tasks_updatecomment_delete` |

**/tasks/update-schedules**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | `/api/v1/tasks/update-schedules` | Read update schedules | `tasks_updateschedule_get` |
| PUT | `/api/v1/tasks/update-schedules` | Set an update schedule | `tasks_updateschedule_set` |

**/tasks/initiative-updates**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| PATCH | `/api/v1/tasks/initiative-updates/{id}` | Edit an initiative status update | `tasks_initiativeupdate_update` |
| DELETE | `/api/v1/tasks/initiative-updates/{id}` | Delete an initiative status update | `tasks_initiativeupdate_delete` |

**/tasks/views**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | `/api/v1/tasks/views` | List saved views | `tasks_view_list` |
| POST | `/api/v1/tasks/views` | Create a saved view | `tasks_view_create` |
| GET | `/api/v1/tasks/views/{id}` | Read a saved view | `tasks_view_get` |
| PATCH | `/api/v1/tasks/views/{id}` | Change a saved view | `tasks_view_update` |
| DELETE | `/api/v1/tasks/views/{id}` | Delete a saved view | `tasks_view_delete` |
| POST | `/api/v1/tasks/views/{id}/duplicate` | Duplicate a saved view | `tasks_view_duplicate` |
| POST | `/api/v1/tasks/views/{id}/subscription` | Follow a saved view | `tasks_view_subscribe` |

**/tasks/favorites**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | `/api/v1/tasks/favorites` | List your favourites | `tasks_favorite_list` |
| POST | `/api/v1/tasks/favorites` | Favourite something | `tasks_favorite_create` |
| PATCH | `/api/v1/tasks/favorites/{id}` | Move a favourite | `tasks_favorite_update` |
| DELETE | `/api/v1/tasks/favorites/{id}` | Remove a favourite | `tasks_favorite_delete` |

**/tasks/notifications**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | `/api/v1/tasks/notifications` | List your notifications | `tasks_notification_list` |
| PATCH | `/api/v1/tasks/notifications/{id}` | Read, archive or snooze a notification | `tasks_notification_update` |
| POST | `/api/v1/tasks/notifications/read-all` | Mark every notification read | `tasks_notification_read_all` |
| GET | `/api/v1/tasks/notifications/settings` | Read your notification settings | `tasks_notification_settings_get` |
| PUT | `/api/v1/tasks/notifications/settings` | Change your notification settings | `tasks_notification_settings_update` |
| PUT | `/api/v1/tasks/notifications/channels` | Turn push or email off for the org | `tasks_notification_channels_update` |

**/tasks/import**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | `/api/v1/tasks/import/jobs` | List imports | `tasks_import_job_list` |
| GET | `/api/v1/tasks/import/jobs/{id}` | Read an import | `tasks_import_job_get` |
| PATCH | `/api/v1/tasks/import/jobs/{id}` | Pause, resume or cancel an import | `tasks_import_job_update` |

**/tasks/export**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | `/api/v1/tasks/export` | List your workspace exports | `tasks_export_list` |
| POST | `/api/v1/tasks/export` | Start a workspace export | `tasks_export_create` |
| GET | `/api/v1/tasks/export/{id}` | Read a workspace export | `tasks_export_get` |
| DELETE | `/api/v1/tasks/export/{id}` | Cancel or delete a workspace export | `tasks_export_cancel` |

**/tasks/agents**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | `/api/v1/tasks/agents` | List agents | `tasks_agent_list` |
| POST | `/api/v1/tasks/agents` | Create a service agent | `tasks_agent_create` |
| PATCH | `/api/v1/tasks/agents/{id}` | Change an agent | `tasks_agent_update` |

**/tasks/github**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | `/api/v1/tasks/github` | Read the GitHub connection | `tasks_github_get` |
| PATCH | `/api/v1/tasks/github` | Set GitHub automations | `tasks_github_update` |
| GET | `/api/v1/tasks/github/summary` | Read the GitHub summary | `tasks_github_summary_get` |
| PUT | `/api/v1/tasks/github/intents` | Set GitHub intent labels | `tasks_github_intent_set` |
| PUT | `/api/v1/tasks/github/rules` | Set a team's GitHub rules | `tasks_github_rule_set` |

**/tasks/releases**

| Method | Path | Summary | MCP tool |
|---|---|---|---|
| GET | `/api/v1/tasks/releases/pipelines` | List release pipelines | `tasks_releasepipeline_list` |
| POST | `/api/v1/tasks/releases/pipelines` | Create a release pipeline | `tasks_releasepipeline_create` |
| PATCH | `/api/v1/tasks/releases/pipelines/{pipeline}` | Change a release pipeline | `tasks_releasepipeline_update` |
| DELETE | `/api/v1/tasks/releases/pipelines/{pipeline}` | Delete a release pipeline | `tasks_releasepipeline_delete` |
| POST | `/api/v1/tasks/releases/pipelines/{pipeline}/restore` | Restore a deleted release pipeline | `tasks_releasepipeline_restore` |
| GET | `/api/v1/tasks/releases/pipelines/{pipeline}/releases` | List releases | `tasks_release_list` |
| POST | `/api/v1/tasks/releases/pipelines/{pipeline}/releases` | Create a release | `tasks_release_create` |
| GET | `/api/v1/tasks/releases` | List releases | `tasks_release_list` |
| GET | `/api/v1/tasks/releases/{release}` | Read a release | `tasks_release_get` |
| PATCH | `/api/v1/tasks/releases/{release}` | Change a release | `tasks_release_update` |
| GET | `/api/v1/tasks/releases/{release}/draft` | Draft release notes | `tasks_release_draft` |
| GET | `/api/v1/tasks/releases/pipelines/{pipeline}/changelog` | Read a pipeline's changelog | `tasks_releasechangelog_get` |
| GET | `/api/v1/tasks/releases/pipelines/{pipeline}/keys` | List a pipeline's CI keys | `tasks_releasekey_list` |
| POST | `/api/v1/tasks/releases/pipelines/{pipeline}/keys` | Create a pipeline CI key | `tasks_releasekey_create` |
| DELETE | `/api/v1/tasks/releases/pipelines/{pipeline}/keys/{key}` | Revoke a pipeline CI key | `tasks_releasekey_revoke` |
| POST | `/api/v1/tasks/releases/{release}/complete` | Complete a release | `tasks_release_complete` |
| POST | `/api/v1/tasks/releases/{release}/issues` | Add issues to a release | `tasks_release_issue_add` |
| DELETE | `/api/v1/tasks/releases/{release}/issues` | Remove issues from a release | `tasks_release_issue_remove` |
| GET | `/api/v1/tasks/releases/automation/{team}` | Read a team's release automation | `tasks_releaseautomation_get` |
| PUT | `/api/v1/tasks/releases/automation/{team}` | Set a team's release automation | `tasks_releaseautomation_update` |

## MCP tools {#tools}

221 tools: 81 read, 140 write. Generated from the code; "write (destructive)" is the tool's `destructiveHint`. A tool with a REST route is the same call over HTTP.

| Tool | Title | Access | Scope | REST route |
|---|---|---|---|---|
| `tasks_activity_list` | List an issue's activity | read | `tasks:read` | `GET /api/v1/tasks/issues/{id}/activity` |
| `tasks_agent_create` | Create a service agent | write | `tasks:write` | `POST /api/v1/tasks/agents` |
| `tasks_agent_list` | List agents | read | `tasks:read` | `GET /api/v1/tasks/agents` |
| `tasks_agent_update` | Change an agent | write | `tasks:write` | `PATCH /api/v1/tasks/agents/{id}` |
| `tasks_attachment_create` | Attach a file to an issue | write | `tasks:write` | `POST /api/v1/tasks/issues/{id}/attachments` |
| `tasks_attachment_delete` | Remove an attachment | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/attachments/{id}` |
| `tasks_attachment_list` | List an issue's attachments | read | `tasks:read` | `GET /api/v1/tasks/issues/{id}/attachments` |
| `tasks_comment_create` | Comment on an issue | write | `tasks:write` | `POST /api/v1/issues/{id}/comments` |
| `tasks_comment_delete` | Delete a comment | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/comments/{id}` |
| `tasks_comment_list` | List an issue's comments | read | `tasks:read` | `GET /api/v1/tasks/issues/{id}/comments` |
| `tasks_comment_update` | Edit a comment | write | `tasks:write` | `PATCH /api/v1/tasks/comments/{id}` |
| `tasks_customer_search` | Find customers to link as requests | read | `tasks:read` | `GET /api/v1/tasks/requests/sources` |
| `tasks_cycle_complete` | Complete a cycle | write | `tasks:write` | `POST /api/v1/tasks/cycles/{id}/complete` |
| `tasks_cycle_create` | Create a cycle | write | `tasks:write` | `POST /api/v1/tasks/teams/{id}/cycles` |
| `tasks_cycle_delete` | Delete a cycle | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/cycles/{id}` |
| `tasks_cycle_get` | Read a cycle | read | `tasks:read` | `GET /api/v1/tasks/cycles/{id}` |
| `tasks_cycle_insight_get` | Read a cycle's insights | read | `tasks:read` | `GET /api/v1/tasks/cycles/{id}/insights` |
| `tasks_cycle_list` | List a team's cycles | read | `tasks:read` | `GET /api/v1/tasks/teams/{id}/cycles` |
| `tasks_cycle_schedule` | Schedule upcoming cycles | write | `tasks:write` | `POST /api/v1/tasks/teams/{id}/cycles/schedule` |
| `tasks_cycle_start` | Start the next cycle today | write | `tasks:write` | `POST /api/v1/tasks/cycles/{id}/start` |
| `tasks_cycle_update` | Change a cycle | write | `tasks:write` | `PATCH /api/v1/tasks/cycles/{id}` |
| `tasks_dependency_list` | List issue dependencies | read | `tasks:read` | `GET /api/v1/tasks/dependencies` |
| `tasks_document_link` | Add a document to a project | write | `tasks:write` | `POST /api/v1/tasks/projects/{id}/documents` |
| `tasks_document_list` | List a project's documents | read | `tasks:read` | `GET /api/v1/tasks/projects/{id}/documents` |
| `tasks_document_unlink` | Remove a document from a project | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/projects/{id}/documents` |
| `tasks_export_cancel` | Cancel or delete a workspace export | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/export/{id}` |
| `tasks_export_create` | Start a workspace export | write | `tasks:write` | `POST /api/v1/tasks/export` |
| `tasks_export_get` | Read a workspace export | read | `tasks:read` | `GET /api/v1/tasks/export/{id}` |
| `tasks_export_list` | List your workspace exports | read | `tasks:read` | `GET /api/v1/tasks/export` |
| `tasks_favorite_create` | Favourite something | write | `tasks:write` | `POST /api/v1/tasks/favorites` |
| `tasks_favorite_delete` | Remove a favourite | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/favorites/{id}` |
| `tasks_favorite_list` | List your favourites | read | `tasks:read` | `GET /api/v1/tasks/favorites` |
| `tasks_favorite_update` | Move a favourite | write | `tasks:write` | `PATCH /api/v1/tasks/favorites/{id}` |
| `tasks_flow_insight_get` | Read a cumulative flow | read | `tasks:read` | `GET /api/v1/tasks/insights/flow` |
| `tasks_follow_list` | List what is in your Pulse | read | `tasks:read` | `GET /api/v1/tasks/pulse/follows` |
| `tasks_github_get` | Read the GitHub connection | read | `tasks:read` | `GET /api/v1/tasks/github` |
| `tasks_github_intent_set` | Set GitHub intent labels | write | `tasks:write` | `PUT /api/v1/tasks/github/intents` |
| `tasks_github_rule_set` | Set a team's GitHub rules | write | `tasks:write` | `PUT /api/v1/tasks/github/rules` |
| `tasks_github_summary_get` | Read the GitHub summary | read | `tasks:read` | `GET /api/v1/tasks/github/summary` |
| `tasks_github_update` | Set GitHub automations | write | `tasks:write` | `PATCH /api/v1/tasks/github` |
| `tasks_import_job_get` | Read an import | read | `tasks:read` | `GET /api/v1/tasks/import/jobs/{id}` |
| `tasks_import_job_list` | List imports | read | `tasks:read` | `GET /api/v1/tasks/import/jobs` |
| `tasks_import_job_update` | Pause, resume or cancel an import | write | `tasks:write` | `PATCH /api/v1/tasks/import/jobs/{id}` |
| `tasks_initiative_create` | Create an initiative | write | `tasks:write` | `POST /api/v1/tasks/initiatives` |
| `tasks_initiative_delete` | Delete an initiative | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/initiatives/{id}` |
| `tasks_initiative_export` | Export initiatives as CSV | read | `tasks:read` | `GET /api/v1/tasks/initiatives/export` |
| `tasks_initiative_follow` | Follow an initiative | write | `tasks:write` | `POST /api/v1/tasks/initiatives/{id}/follow` |
| `tasks_initiative_get` | Read an initiative | read | `tasks:read` | `GET /api/v1/tasks/initiatives/{id}` |
| `tasks_initiative_list` | List initiatives | read | `tasks:read` | `GET /api/v1/tasks/initiatives` |
| `tasks_initiative_unfollow` | Unfollow an initiative | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/initiatives/{id}/follow` |
| `tasks_initiative_update` | Change an initiative | write | `tasks:write` | `PATCH /api/v1/tasks/initiatives/{id}` |
| `tasks_initiative_update_create` | Post an initiative status update | write | `tasks:write` | `POST /api/v1/tasks/initiatives/{id}/updates` |
| `tasks_initiative_update_list` | List an initiative's status updates | read | `tasks:read` | `GET /api/v1/tasks/initiatives/{id}/updates` |
| `tasks_initiativeupdate_delete` | Delete an initiative status update | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/initiative-updates/{id}` |
| `tasks_initiativeupdate_update` | Edit an initiative status update | write | `tasks:write` | `PATCH /api/v1/tasks/initiative-updates/{id}` |
| `tasks_insight_get` | Read Tasks insights | read | `tasks:read` | `GET /api/v1/tasks/insights` |
| `tasks_issue_batch` | Change many issues at once | write | `tasks:write` | `POST /api/v1/tasks/issues/batch` |
| `tasks_issue_claim` | Claim an issue | write | `tasks:write` | `POST /api/v1/issues/{id}/claim` |
| `tasks_issue_convert_to_project` | Convert an issue to a project | write | `tasks:write` | `POST /api/v1/tasks/issues/{id}/convert-to-project` |
| `tasks_issue_create` | Create an issue | write | `tasks:write` | `POST /api/v1/issues` |
| `tasks_issue_delete` | Delete an issue | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/issues/{id}` |
| `tasks_issue_duplicate` | Make a copy of an issue | write | `tasks:write` | `POST /api/v1/tasks/issues/{id}/duplicate` |
| `tasks_issue_export` | Export a list of issues as CSV | read | `tasks:read` | `GET /api/v1/tasks/issues/export` |
| `tasks_issue_get` | Read an issue | read | `tasks:read` | `GET /api/v1/issues/{id}` |
| `tasks_issue_history` | List an issue's description versions | read | `tasks:read` | `GET /api/v1/tasks/issues/{id}/history` |
| `tasks_issue_list_mine` | List my issues | read | `tasks:read` | `GET /api/v1/issues/mine` |
| `tasks_issue_move` | Move issues to another team | write | `tasks:write` | `POST /api/v1/tasks/issues/move` |
| `tasks_issue_progress` | Report progress | write | `tasks:write` | `POST /api/v1/issues/{id}/progress` |
| `tasks_issue_revert` | Restore an earlier description | write | `tasks:write` | `POST /api/v1/tasks/issues/{id}/history/{version_id}/restore` |
| `tasks_issue_search` | Search issues | read | `tasks:read` | `GET /api/v1/issues` |
| `tasks_issue_subscribe` | Subscribe to an issue | write | `tasks:write` | `POST /api/v1/tasks/issues/{id}/subscribe` |
| `tasks_issue_triage` | Triage an issue | write | `tasks:write` | `POST /api/v1/tasks/issues/{id}/triage` |
| `tasks_issue_unsubscribe` | Unsubscribe from an issue | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/issues/{id}/subscribe` |
| `tasks_issue_update` | Update an issue | write | `tasks:write` | `PATCH /api/v1/issues/{id}` |
| `tasks_label_create` | Create a label | write | `tasks:write` | `POST /api/v1/tasks/labels` |
| `tasks_label_delete` | Delete a label | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/labels/{id}` |
| `tasks_label_list` | List labels | read | `tasks:read` | `GET /api/v1/tasks/labels` |
| `tasks_label_update` | Change a label | write | `tasks:write` | `PATCH /api/v1/tasks/labels/{id}` |
| `tasks_labelgroup_create` | Create a label group | write | `tasks:write` | `POST /api/v1/tasks/label-groups` |
| `tasks_labelgroup_delete` | Delete a label group | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/label-groups/{id}` |
| `tasks_labelgroup_list` | List label groups | read | `tasks:read` | `GET /api/v1/tasks/label-groups` |
| `tasks_labelgroup_update` | Change a label group | write | `tasks:write` | `PATCH /api/v1/tasks/label-groups/{id}` |
| `tasks_link_create` | Add a link to an issue | write | `tasks:write` | `POST /api/v1/tasks/issues/{id}/links` |
| `tasks_link_delete` | Remove a link | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/links/{id}` |
| `tasks_link_list` | List an issue's links | read | `tasks:read` | `GET /api/v1/tasks/issues/{id}/links` |
| `tasks_link_update` | Edit a link | write | `tasks:write` | `PATCH /api/v1/tasks/links/{id}` |
| `tasks_member_export` | Export members as CSV | read | `tasks:read` | `GET /api/v1/tasks/members/export` |
| `tasks_member_list` | List the organisation's members | read | `tasks:read` | `GET /api/v1/tasks/members` |
| `tasks_milestone_create` | Add a milestone | write | `tasks:write` | `POST /api/v1/tasks/projects/{project_id}/milestones` |
| `tasks_milestone_delete` | Delete a milestone | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/milestones/{id}` |
| `tasks_milestone_list` | List milestones | read | `tasks:read` | `GET /api/v1/tasks/projects/{project_id}/milestones` (+1) |
| `tasks_milestone_update` | Change a milestone | write | `tasks:write` | `PATCH /api/v1/tasks/milestones/{id}` |
| `tasks_note_link` | Link or create a note for an issue | write | `tasks:write` | `POST /api/v1/tasks/issues/{id}/notes` |
| `tasks_note_list` | List an issue's linked notes | read | `tasks:read` | `GET /api/v1/tasks/issues/{id}/notes` |
| `tasks_note_unlink` | Unlink a note from an issue | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/issues/{id}/notes` |
| `tasks_notification_channels_update` | Turn push or email off for the org | write | `tasks:write` | `PUT /api/v1/tasks/notifications/channels` |
| `tasks_notification_list` | List your notifications | read | `tasks:read` | `GET /api/v1/tasks/notifications` |
| `tasks_notification_read_all` | Mark every notification read | write | `tasks:write` | `POST /api/v1/tasks/notifications/read-all` |
| `tasks_notification_settings_get` | Read your notification settings | read | `tasks:read` | `GET /api/v1/tasks/notifications/settings` |
| `tasks_notification_settings_update` | Change your notification settings | write | `tasks:write` | `PUT /api/v1/tasks/notifications/settings` |
| `tasks_notification_update` | Read, archive or snooze a notification | write | `tasks:write` | `PATCH /api/v1/tasks/notifications/{id}` |
| `tasks_project_activity` | List a project's activity | read | `tasks:read` | `GET /api/v1/tasks/projects/{id}/activity` |
| `tasks_project_create` | Create a project | write | `tasks:write` | `POST /api/v1/tasks/projects` |
| `tasks_project_delete` | Delete a project | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/projects/{id}` |
| `tasks_project_export` | Export projects as CSV | read | `tasks:read` | `GET /api/v1/tasks/projects/export` |
| `tasks_project_follow` | Follow a project | write | `tasks:write` | `POST /api/v1/tasks/projects/{id}/follow` |
| `tasks_project_get` | Read a project | read | `tasks:read` | `GET /api/v1/tasks/projects/{id}` |
| `tasks_project_insight_get` | Read a project's insights | read | `tasks:read` | `GET /api/v1/tasks/projects/{id}/insights` |
| `tasks_project_list` | List projects | read | `tasks:read` | `GET /api/v1/tasks/projects` |
| `tasks_project_move` | Move a project to another team | write | `tasks:write` | `POST /api/v1/tasks/projects/{id}/move` |
| `tasks_project_unfollow` | Unfollow a project | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/projects/{id}/follow` |
| `tasks_project_update` | Change a project | write | `tasks:write` | `PATCH /api/v1/tasks/projects/{id}` |
| `tasks_projectdep_add` | Add a project dependency | write | `tasks:write` | `POST /api/v1/tasks/projects/{project}/dependencies` |
| `tasks_projectdep_list` | List project dependencies | read | `tasks:read` | `GET /api/v1/tasks/projects/{project}/dependencies` (+1) |
| `tasks_projectdep_remove` | Remove a project dependency | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/projects/{project}/dependencies` |
| `tasks_projectlink_create` | Add a link to a project | write | `tasks:write` | `POST /api/v1/tasks/projects/{id}/links` |
| `tasks_projectlink_list` | List a project's links | read | `tasks:read` | `GET /api/v1/tasks/projects/{id}/links` |
| `tasks_projectrequest_create` | Add a customer request to a project | write | `tasks:write` | `POST /api/v1/tasks/projects/{id}/requests` |
| `tasks_projectrequest_list` | List a project's customer requests | read | `tasks:read` | `GET /api/v1/tasks/projects/{id}/requests` |
| `tasks_projectupdate_create` | Post a project status update | write | `tasks:write` | `POST /api/v1/tasks/projects/{id}/updates` |
| `tasks_projectupdate_delete` | Delete a project status update | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/project-updates/{id}` |
| `tasks_projectupdate_list` | List a project's status updates | read | `tasks:read` | `GET /api/v1/tasks/projects/{id}/updates` |
| `tasks_projectupdate_update` | Edit a project status update | write | `tasks:write` | `PATCH /api/v1/tasks/project-updates/{id}` |
| `tasks_pullrequest_link` | Refresh an issue's pull requests | write | `tasks:write` | `POST /api/v1/tasks/issues/{id}/pull-requests` |
| `tasks_pullrequest_list` | List an issue's pull requests | read | `tasks:read` | `GET /api/v1/tasks/issues/{id}/pull-requests` |
| `tasks_pullrequest_unlink` | Unlink a pull request from an issue | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/issues/{id}/pull-requests/{pr_id}` |
| `tasks_pulse_digest_create` | Make last week's Pulse digest | write | `tasks:write` | `POST /api/v1/tasks/pulse/digests` |
| `tasks_pulse_digest_get` | Read a Pulse digest | read | `tasks:read` | `GET /api/v1/tasks/pulse/digests/{id}` |
| `tasks_pulse_digest_list` | List your weekly Pulse digests | read | `tasks:read` | `GET /api/v1/tasks/pulse/digests` |
| `tasks_pulse_digest_update` | Mark a Pulse digest read | write | `tasks:write` | `PATCH /api/v1/tasks/pulse/digests/{id}` |
| `tasks_pulse_get` | Read your Pulse | read | `tasks:read` | `GET /api/v1/tasks/pulse` |
| `tasks_pulse_settings_get` | Read the org's Pulse settings | read | `tasks:read` | `GET /api/v1/tasks/pulse/settings` |
| `tasks_pulse_settings_update` | Change the org's Pulse settings | write | `tasks:write` | `PUT /api/v1/tasks/pulse/settings` |
| `tasks_reaction_add` | React with an emoji | write | `tasks:write` | `POST /api/v1/tasks/comments/{comment_id}/reactions` (+1) |
| `tasks_reaction_remove` | Remove a reaction | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/comments/{comment_id}/reactions` (+1) |
| `tasks_recurring_create` | Create a recurring issue | write | `tasks:write` | `POST /api/v1/tasks/teams/{id}/recurring` |
| `tasks_recurring_delete` | Delete a recurring issue | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/recurring/{id}` |
| `tasks_recurring_get` | Read a recurring issue | read | `tasks:read` | `GET /api/v1/tasks/recurring/{id}` |
| `tasks_recurring_list` | List a team's recurring issues | read | `tasks:read` | `GET /api/v1/tasks/teams/{id}/recurring` |
| `tasks_recurring_update` | Change a recurring issue | write | `tasks:write` | `PATCH /api/v1/tasks/recurring/{id}` |
| `tasks_relation_create` | Relate two issues | write | `tasks:write` | `POST /api/v1/tasks/issues/{id}/relations` |
| `tasks_relation_delete` | Remove an issue relation | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/relations/{id}` |
| `tasks_release_complete` | Complete a release | write | `tasks:write` | `POST /api/v1/tasks/releases/{release}/complete` |
| `tasks_release_create` | Create a release | write | `tasks:write` | `POST /api/v1/tasks/releases/pipelines/{pipeline}/releases` |
| `tasks_release_draft` | Draft release notes | read | `tasks:read` | `GET /api/v1/tasks/releases/{release}/draft` |
| `tasks_release_get` | Read a release | read | `tasks:read` | `GET /api/v1/tasks/releases/{release}` |
| `tasks_release_issue_add` | Add issues to a release | write | `tasks:write` | `POST /api/v1/tasks/releases/{release}/issues` |
| `tasks_release_issue_remove` | Remove issues from a release | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/releases/{release}/issues` |
| `tasks_release_list` | List releases | read | `tasks:read` | `GET /api/v1/tasks/releases/pipelines/{pipeline}/releases` (+1) |
| `tasks_release_update` | Change a release | write | `tasks:write` | `PATCH /api/v1/tasks/releases/{release}` |
| `tasks_releaseautomation_get` | Read a team's release automation | read | `tasks:read` | `GET /api/v1/tasks/releases/automation/{team}` |
| `tasks_releaseautomation_update` | Set a team's release automation | write | `tasks:write` | `PUT /api/v1/tasks/releases/automation/{team}` |
| `tasks_releasechangelog_get` | Read a pipeline's changelog | read | `tasks:read` | `GET /api/v1/tasks/releases/pipelines/{pipeline}/changelog` |
| `tasks_releasekey_create` | Create a pipeline CI key | write | `tasks:write` | `POST /api/v1/tasks/releases/pipelines/{pipeline}/keys` |
| `tasks_releasekey_list` | List a pipeline's CI keys | read | `tasks:read` | `GET /api/v1/tasks/releases/pipelines/{pipeline}/keys` |
| `tasks_releasekey_revoke` | Revoke a pipeline CI key | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/releases/pipelines/{pipeline}/keys/{key}` |
| `tasks_releasepipeline_create` | Create a release pipeline | write | `tasks:write` | `POST /api/v1/tasks/releases/pipelines` |
| `tasks_releasepipeline_delete` | Delete a release pipeline | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/releases/pipelines/{pipeline}` |
| `tasks_releasepipeline_list` | List release pipelines | read | `tasks:read` | `GET /api/v1/tasks/releases/pipelines` |
| `tasks_releasepipeline_restore` | Restore a deleted release pipeline | write | `tasks:write` | `POST /api/v1/tasks/releases/pipelines/{pipeline}/restore` |
| `tasks_releasepipeline_update` | Change a release pipeline | write | `tasks:write` | `PATCH /api/v1/tasks/releases/pipelines/{pipeline}` |
| `tasks_reminder_delete` | Cancel a reminder | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/reminders/{id}` |
| `tasks_reminder_list` | List your reminders | read | `tasks:read` | `GET /api/v1/tasks/reminders` |
| `tasks_reminder_set` | Set a reminder | write | `tasks:write` | `PUT /api/v1/tasks/reminders` |
| `tasks_request_create` | Add a customer request to an issue | write | `tasks:write` | `POST /api/v1/tasks/issues/{id}/requests` |
| `tasks_request_delete` | Remove a customer request | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/requests/{id}` |
| `tasks_request_list` | List an issue's customer requests | read | `tasks:read` | `GET /api/v1/tasks/issues/{id}/requests` |
| `tasks_request_update` | Change a customer request's quote | write | `tasks:write` | `PATCH /api/v1/tasks/requests/{id}` |
| `tasks_saved_insight_create` | Save an insight | write | `tasks:write` | `POST /api/v1/tasks/saved-insights` |
| `tasks_saved_insight_delete` | Delete a saved insight | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/saved-insights/{id}` |
| `tasks_saved_insight_get` | Read a saved insight | read | `tasks:read` | `GET /api/v1/tasks/saved-insights/{id}` |
| `tasks_saved_insight_list` | List saved insights | read | `tasks:read` | `GET /api/v1/tasks/saved-insights` |
| `tasks_saved_insight_run` | Run a saved insight | read | `tasks:read` | `GET /api/v1/tasks/saved-insights/{id}/result` |
| `tasks_saved_insight_update` | Change a saved insight | write | `tasks:write` | `PATCH /api/v1/tasks/saved-insights/{id}` |
| `tasks_sla_get` | Read a team's SLA rules | read | `tasks:read` | `GET /api/v1/tasks/teams/{id}/sla` |
| `tasks_sla_set` | Set a team's SLA rules | write | `tasks:write` | `PUT /api/v1/tasks/teams/{id}/sla` |
| `tasks_state_create` | Add a workflow state | write | `tasks:write` | `POST /api/v1/tasks/teams/{id}/states` |
| `tasks_state_delete` | Delete a workflow state | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/states/{id}` |
| `tasks_state_list` | List a team's workflow states | read | `tasks:read` | `GET /api/v1/tasks/teams/{id}/states` |
| `tasks_state_reorder` | Reorder workflow states | write | `tasks:write` | `POST /api/v1/tasks/teams/{id}/states/reorder` |
| `tasks_state_update` | Change a workflow state | write | `tasks:write` | `PATCH /api/v1/tasks/states/{id}` |
| `tasks_suggestion_create` | Ask for AI suggestions | write | `tasks:write` | `POST /api/v1/tasks/issues/{id}/suggestions` |
| `tasks_suggestion_decide` | Accept or dismiss a suggestion | write | `tasks:write` | `POST /api/v1/tasks/suggestions/{id}` |
| `tasks_suggestion_list` | List AI suggestions for an issue | read | `tasks:read` | `GET /api/v1/tasks/issues/{id}/suggestions` |
| `tasks_team_create` | Create a team | write | `tasks:write` | `POST /api/v1/tasks/teams` |
| `tasks_team_delete` | Delete a team | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/teams/{id}` |
| `tasks_team_list` | List teams | read | `tasks:read` | `GET /api/v1/teams` |
| `tasks_team_update` | Change a team | write | `tasks:write` | `PATCH /api/v1/tasks/teams/{id}` |
| `tasks_teammember_add` | Add a member to a team | write | `tasks:write` | `POST /api/v1/tasks/teams/{id}/members` |
| `tasks_teammember_list` | List a team's members | read | `tasks:read` | `GET /api/v1/tasks/teams/{id}/members` |
| `tasks_teammember_remove` | Remove a member from a team | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/teams/{id}/members/{member_id}` |
| `tasks_template_apply` | Apply a template to an issue | write | `tasks:write` | `POST /api/v1/tasks/issues/{id}/apply-template` |
| `tasks_template_create` | Create an issue template | write | `tasks:write` | `POST /api/v1/tasks/teams/{id}/templates` (+1) |
| `tasks_template_delete` | Delete an issue template | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/templates/{id}` |
| `tasks_template_get` | Read an issue template | read | `tasks:read` | `GET /api/v1/tasks/templates/{id}` |
| `tasks_template_list` | List issue templates | read | `tasks:read` | `GET /api/v1/tasks/teams/{id}/templates` (+1) |
| `tasks_template_update` | Change an issue template | write | `tasks:write` | `PATCH /api/v1/tasks/templates/{id}` |
| `tasks_thread_mute` | Mute or unmute a comment thread | write | `tasks:write` | `PUT /api/v1/tasks/comments/{comment}/mute` |
| `tasks_triage_get` | Read a team's AI triage settings | read | `tasks:read` | `GET /api/v1/tasks/teams/{id}/ai-triage` |
| `tasks_triage_set` | Set a team's AI triage settings | write | `tasks:write` | `PUT /api/v1/tasks/teams/{id}/ai-triage` |
| `tasks_triagerule_create` | Create a triage rule | write | `tasks:write` | `POST /api/v1/tasks/teams/{id}/triage-rules` |
| `tasks_triagerule_delete` | Delete a triage rule | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/triage-rules/{id}` |
| `tasks_triagerule_get` | Read a triage rule | read | `tasks:read` | `GET /api/v1/tasks/triage-rules/{id}` |
| `tasks_triagerule_list` | List a team's triage rules | read | `tasks:read` | `GET /api/v1/tasks/teams/{id}/triage-rules` |
| `tasks_triagerule_reorder` | Reorder a team's triage rules | write | `tasks:write` | `POST /api/v1/tasks/teams/{id}/triage-rules/reorder` |
| `tasks_triagerule_test` | Try a triage rule | read | `tasks:read` | `POST /api/v1/tasks/teams/{id}/triage-rules/test` |
| `tasks_triagerule_update` | Change a triage rule | write | `tasks:write` | `PATCH /api/v1/tasks/triage-rules/{id}` |
| `tasks_updatecomment_create` | Comment on an update | write | `tasks:write` | `POST /api/v1/tasks/updates/{update_kind}/{update_id}/comments` |
| `tasks_updatecomment_delete` | Delete a comment on an update | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/update-comments/{id}` |
| `tasks_updatecomment_list` | List comments on an update | read | `tasks:read` | `GET /api/v1/tasks/updates/{update_kind}/{update_id}/comments` |
| `tasks_updatecomment_update` | Edit a comment on an update | write | `tasks:write` | `PATCH /api/v1/tasks/update-comments/{id}` |
| `tasks_updatereaction_set` | React to an update | write | `tasks:write` | `PUT /api/v1/tasks/updates/{update_kind}/{update_id}/reactions` |
| `tasks_updateschedule_get` | Read update schedules | read | `tasks:read` | `GET /api/v1/tasks/update-schedules` |
| `tasks_updateschedule_set` | Set an update schedule | write | `tasks:write` | `PUT /api/v1/tasks/update-schedules` |
| `tasks_view_create` | Create a saved view | write | `tasks:write` | `POST /api/v1/tasks/views` |
| `tasks_view_delete` | Delete a saved view | write (destructive) | `tasks:write` | `DELETE /api/v1/tasks/views/{id}` |
| `tasks_view_duplicate` | Duplicate a saved view | write | `tasks:write` | `POST /api/v1/tasks/views/{id}/duplicate` |
| `tasks_view_get` | Read a saved view | read | `tasks:read` | `GET /api/v1/tasks/views/{id}` |
| `tasks_view_list` | List saved views | read | `tasks:read` | `GET /api/v1/tasks/views` |
| `tasks_view_subscribe` | Follow a saved view | write | `tasks:write` | `POST /api/v1/tasks/views/{id}/subscription` |
| `tasks_view_update` | Change a saved view | write | `tasks:write` | `PATCH /api/v1/tasks/views/{id}` |

## Related {#related}

- [Venom Tasks for agents](/docs/cloud/tasks-mcp.md): connecting clients, AI triage, linked notes and troubleshooting.
- [Venom Tasks API](/docs/cloud/tasks-api.md): the app's console API and its request fields, which the tools above take.
- [GitHub](/docs/cloud/tasks-github.md): linking pull requests and GitHub issues as intents.
- [The REST twin](/docs/developers/rest.md) and [Venom for agents](/docs/cloud/workspace-mcp.md): the shared envelope, `If-Match` and `Idempotency-Key`.
- [Authentication and scopes](/docs/developers/auth.md), [Webhooks](/docs/developers/webhooks.md) and [Errors, limits and pagination](/docs/developers/conventions.md).
