> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to BugHerd

The BugHerd connector lets your AI agent act in each user's BugHerd account. Each user connects their own BugHerd API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 37 tools.

**Authentication:** API Key
**Categories:** Project Management, Developer Tools
**Tools:** 37: 22 read, 12 write, 3 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=BUGHERD)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the BugHerd connection

   In **AgentKit > Connections**, create a BugHerd connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'bugherd_attachment_get',
  toolInput: {
    attachment_id: 3141,
    project_id: 12345,
    task_id: 987654,
  },
  connector: 'bugherd',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="bugherd_attachment_get",
    tool_input={
        "attachment_id": 3141,
        "project_id": 12345,
        "task_id": 987654,
    },
    connection_name="bugherd",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `bugherd_attachment_get`

Get Attachment · Read-only

Get one attachment of a task.
Returns its file name and download URL.
Use bugherd_attachment_get when you know the attachment ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `attachment_id` (`integer`, required): Attachment ID, from bugherd_attachments_list. Example: 3141
- `project_id` (`integer`, required): Project ID, from bugherd_projects_list. Example: 12345
- `task_id` (`integer`, required): Task ID (the global task ID returned by the task list tools). Example: 987654

Example input: `{"attachment_id":3141,"project_id":12345,"task_id":987654}`

### `bugherd_attachments_list`

List Attachments · Read-only

List the files attached to a task.
Returns each attachment's ID, file name and URL.
Use bugherd_attachments_list to get screenshots or files reported with a task.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`integer`, required): Project ID, from bugherd_projects_list. Example: 12345
- `task_id` (`integer`, required): Task ID (the global task ID returned by the task list tools). Example: 987654

Example input: `{"project_id":12345,"task_id":987654}`

### `bugherd_column_get`

Get Column · Read-only

Get one board column.
Returns the column's ID, name and position.
Use bugherd_column_get when you know the column ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `column_id` (`integer`, required): Column ID, from bugherd_columns_list. Example: 55
- `project_id` (`integer`, required): Project ID, from bugherd_projects_list. Example: 12345

Example input: `{"column_id":55,"project_id":12345}`

### `bugherd_columns_list`

List Columns · Read-only

List a project's board columns, built-in (backlog, todo, doing, done) and custom.
Returns each column's ID, name and position.
Use bugherd_columns_list to find valid status values for tasks.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`integer`, required): Project ID, from bugherd_projects_list. Example: 12345

Example input: `{"project_id":12345}`

### `bugherd_comments_list`

List Comments · Read-only

List the comments on a task.
Returns each comment's text, author, privacy and time.
Use bugherd_comments_list to read a task's discussion.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`integer`, required): Project ID, from bugherd_projects_list. Example: 12345
- `task_id` (`integer`, required): Task ID (the global task ID returned by the task list tools). Example: 987654

Example input: `{"project_id":12345,"task_id":987654}`

### `bugherd_guests_list`

List Guests · Read-only

List the organization's guests (clients invited to give feedback on projects).
Returns a page of guests with ID, name and email.
Use bugherd_guests_list to see external reviewers.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `page` (`integer`, optional): Page number, starting at 1; each page holds up to 100 records and an empty page means the end. Example: 1

Example input: `{}`

### `bugherd_members_list`

List Members · Read-only

List the organization's team members (not guests).
Returns a page of members with ID, name and email.
Use bugherd_members_list to find people to assign tasks to.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `page` (`integer`, optional): Page number, starting at 1; each page holds up to 100 records and an empty page means the end. Example: 1

Example input: `{}`

### `bugherd_organization_get`

Get Organization · Read-only

Get your BugHerd organization's details.
Returns the organization's ID and name.
Use bugherd_organization_get to check the connection.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `bugherd_project_get`

Get Project · Read-only

Get one project with its members, guests and columns.
Returns the project's name, website URL, settings, members, guests and column configuration.
Use bugherd_project_get to see who is on a project and its board columns.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`integer`, required): Project ID, from bugherd_projects_list. Example: 12345

Example input: `{"project_id":12345}`

### `bugherd_projects_active_list`

List Active Projects · Read-only

List only active projects.
Returns a page of active projects.
Use bugherd_projects_active_list for projects currently collecting feedback.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `page` (`integer`, optional): Page number, starting at 1; each page holds up to 100 records and an empty page means the end. Example: 1

Example input: `{}`

### `bugherd_projects_list`

List Projects · Read-only

List all projects in the organization, active and inactive.
Returns a page of projects with ID, name, website URL and status.
Use bugherd_projects_list to find a project ID. Use bugherd_projects_active_list for active projects only.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `page` (`integer`, optional): Page number, starting at 1; each page holds up to 100 records and an empty page means the end. Example: 1

Example input: `{}`

### `bugherd_task_get`

Get Task · Read-only

Get one task with full details, including the page URL, browser and screen info and screenshot.
Returns the task's description, status, priority, tags, assignees, requester, metadata and screenshot URL.
Use bugherd_task_get when you have the project and task IDs. Use bugherd_task_get_global with only a task ID, or bugherd_task_get_by_local_id with the #number.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`integer`, required): Project ID, from bugherd_projects_list. Example: 12345
- `task_id` (`integer`, required): Task ID (the global task ID returned by the task list tools). Example: 987654

Example input: `{"project_id":12345,"task_id":987654}`

### `bugherd_task_get_by_local_id`

Get Task by Number · Read-only

Get a task by its project task number (the #42 shown in BugHerd).
Returns the task's details, including its global ID.
Use bugherd_task_get_by_local_id when you have the number from the UI or a link.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `local_task_id` (`integer`, required): Project-scoped task number, as shown in the UI (for example 42). Example: 42
- `project_id` (`integer`, required): Project ID, from bugherd_projects_list. Example: 12345

Example input: `{"local_task_id":42,"project_id":12345}`

### `bugherd_task_get_global`

Get Task by ID · Read-only

Get a task by its global ID without knowing its project.
Returns the task's details and project.
Use bugherd_task_get_global when you only have a task ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `task_id` (`integer`, required): Task ID (the global task ID returned by the task list tools). Example: 987654

Example input: `{"task_id":987654}`

### `bugherd_tasks_archive_list`

List Archived Tasks · Read-only

List a project's closed or archived tasks.
Returns a page of tasks.
Use bugherd_tasks_archive_list to review finished work.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`integer`, required): Project ID, from bugherd_projects_list. Example: 12345
- `page` (`integer`, optional): Page number, starting at 1; each page holds up to 100 records and an empty page means the end. Example: 1

Example input: `{"project_id":12345}`

### `bugherd_tasks_feedback_list`

List Feedback Tasks · Read-only

List the tasks waiting in a project's Feedback panel (new, unprocessed reports).
Returns a page of tasks.
Use bugherd_tasks_feedback_list to triage incoming bug reports.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`integer`, required): Project ID, from bugherd_projects_list. Example: 12345
- `page` (`integer`, optional): Page number, starting at 1; each page holds up to 100 records and an empty page means the end. Example: 1

Example input: `{"project_id":12345}`

### `bugherd_tasks_list`

List Tasks · Read-only

List a project's tasks, filtered by status, priority, tag, assignee, external ID or date.
Returns a page of tasks with ID, local ID, description, status, priority, tags and assignees.
Use bugherd_tasks_list to search a project. Use bugherd_tasks_feedback_list, bugherd_tasks_taskboard_list or bugherd_tasks_archive_list for one area of the board.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`integer`, required): Project ID, from bugherd_projects_list. Example: 12345
- `assigned_to_id` (`integer`, optional): Only tasks assigned to this user ID. Example: 4321
- `created_since` (`string`, optional): Only tasks created after this ISO 8601 time. Example: 2026-11-01T00:00:00Z
- `external_id` (`string`, optional): Only the task with this external ID. Example: JIRA-123
- `page` (`integer`, optional): Page number, starting at 1; each page holds up to 100 records and an empty page means the end. Example: 1
- `priority` (`string`, optional): Only tasks with this priority. One of: not set, critical, important, normal, minor. Example: critical. One of: `not set`, `critical`, `important`, `normal`, `minor`.
- `status` (`string`, optional): Only tasks in this status or column, for example backlog, todo, doing or done. Example: todo
- `tag` (`string`, optional): Only tasks with this tag. Example: homepage
- `updated_since` (`string`, optional): Only tasks updated after this ISO 8601 time. Example: 2026-11-01T00:00:00Z

Example input: `{"project_id":12345}`

### `bugherd_tasks_taskboard_list`

List Taskboard Tasks · Read-only

List all active (not archived) tasks on a project's taskboard.
Returns a page of tasks.
Use bugherd_tasks_taskboard_list to see current work.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`integer`, required): Project ID, from bugherd_projects_list. Example: 12345
- `page` (`integer`, optional): Page number, starting at 1; each page holds up to 100 records and an empty page means the end. Example: 1

Example input: `{"project_id":12345}`

### `bugherd_user_projects_list`

List User Projects · Read-only

List the projects a user belongs to.
Returns a page of projects.
Use bugherd_user_projects_list to see where a user has access.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `user_id` (`integer`, required): User ID, from bugherd_users_list. Example: 4321
- `created_since` (`string`, optional): Only projects created after this ISO 8601 time. Example: 2026-01-01T00:00:00Z
- `is_active` (`boolean`, optional): true for active projects only, false for inactive only. Example: true
- `page` (`integer`, optional): Page number, starting at 1; each page holds up to 100 records and an empty page means the end. Example: 1

Example input: `{"user_id":4321}`

### `bugherd_user_tasks_list`

List User Tasks · Read-only

List the tasks assigned to a user across all projects, optionally filtered by date, priority, tag or assignee.
Returns a page of tasks.
Use bugherd_user_tasks_list for someone's workload. Use bugherd_tasks_list for one project.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `user_id` (`integer`, required): User ID, from bugherd_users_list. Example: 4321
- `assigned_to_id` (`integer`, optional): Only tasks assigned to this user ID. Example: 4321
- `created_since` (`string`, optional): Only tasks created after this ISO 8601 time. Example: 2026-11-01T00:00:00Z
- `page` (`integer`, optional): Page number, starting at 1; each page holds up to 100 records and an empty page means the end. Example: 1
- `priority` (`string`, optional): Only tasks with this priority. One of: not set, critical, important, normal, minor. Example: critical. One of: `not set`, `critical`, `important`, `normal`, `minor`.
- `tag` (`string`, optional): Only tasks with this tag. Example: homepage
- `updated_since` (`string`, optional): Only tasks updated after this ISO 8601 time. Example: 2026-11-01T00:00:00Z

Example input: `{"user_id":4321}`

### `bugherd_users_list`

List Users · Read-only

List all users in the organization, both team members and guests (clients).
Returns a page of users with ID, name, email and whether each is a guest.
Use bugherd_users_list to find a user ID. Use bugherd_members_list or bugherd_guests_list for one kind only.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `page` (`integer`, optional): Page number, starting at 1; each page holds up to 100 records and an empty page means the end. Example: 1
- `updated_since` (`string`, optional): Only users updated after this ISO 8601 time. Example: 2026-11-01T00:00:00Z

Example input: `{}`

### `bugherd_webhooks_list`

List Webhooks · Read-only

List the organization's webhooks with delivery statistics and errors.
Returns each webhook's ID, event, target URL, project and delivery stats.
Use bugherd_webhooks_list to check which events are sent where.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `bugherd_attachment_create`

Attach File from URL · Write

Attach a file to a task from a public URL; BugHerd downloads and stores a copy.
Returns the created attachment.
Use bugherd_attachment_create to add a screenshot or log that is already online.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `file_name` (`string`, required): File name to store it as. Example: error-log.txt
- `project_id` (`integer`, required): Project ID, from bugherd_projects_list. Example: 12345
- `task_id` (`integer`, required): Task ID (the global task ID returned by the task list tools). Example: 987654
- `url` (`string`, required): Publicly reachable URL of the file. Example: https://example.com/files/error-log.txt

Example input: `{"file_name":"<file_name>","project_id":12345,"task_id":987654,"url":"<url>"}`

### `bugherd_column_create`

Create Column · Write

Add a custom column to the end of a project's board.
Returns the created column.
Use bugherd_column_create for a new workflow stage such as QA.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Column name. Example: QA
- `project_id` (`integer`, required): Project ID, from bugherd_projects_list. Example: 12345

Example input: `{"name":"<name>","project_id":12345}`

### `bugherd_column_update`

Rename Column · Write

Rename a custom column.
Returns the updated column.
Use bugherd_column_update to rename a stage.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `column_id` (`integer`, required): Column ID, from bugherd_columns_list. Example: 55
- `name` (`string`, required): New column name. Example: Ready for QA
- `project_id` (`integer`, required): Project ID, from bugherd_projects_list. Example: 12345

Example input: `{"column_id":55,"name":"<name>","project_id":12345}`

### `bugherd_comment_create`

Create Comment · Write

Add a comment to a task, optionally private to team members.
Returns the created comment.
Use bugherd_comment_create to reply to a reporter or add notes; set is_private to hide it from guests.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `project_id` (`integer`, required): Project ID, from bugherd_projects_list. Example: 12345
- `task_id` (`integer`, required): Task ID (the global task ID returned by the task list tools). Example: 987654
- `text` (`string`, required): Comment text. Example: Fixed in build 1.4.2, please re-check.
- `email` (`string`, optional): Email of the commenter, as an alternative to user_id. Example: dev@yourcompany.com
- `is_private` (`boolean`, optional): true makes the comment visible to team members only. Example: false
- `user_id` (`integer`, optional): User ID of the commenter. Example: 4321

Example input: `{"project_id":12345,"task_id":987654,"text":"<text>"}`

### `bugherd_project_create`

Create Project · Write

Create a project for a website; it starts with no members or guests.
Returns the created project with its ID.
Use bugherd_project_create for a new site, then add people with bugherd_project_member_add and bugherd_project_guest_add.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `devurl` (`string`, required): Main website URL the project collects feedback on. Example: https://staging.acme.com
- `name` (`string`, required): Project name. Example: Acme website redesign
- `guests_see_guests` (`boolean`, optional): Let guests see other guests' feedback. Example: false
- `is_active` (`boolean`, optional): Whether the project is active. Example: true
- `is_public` (`boolean`, optional): Enable public feedback, so anyone visiting the site can report issues. Example: false

Example input: `{"devurl":"<devurl>","name":"<name>"}`

### `bugherd_project_guest_add`

Add Project Guest · Write

Add a guest (client) to a project by user ID, or invite one by email.
Returns the result. An email invitation is sent to new guests.
Use bugherd_project_guest_add to let a client report feedback on a project.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `project_id` (`integer`, required): Project ID, from bugherd_projects_list. Example: 12345
- `email` (`string`, optional): Email to invite as a new guest; give this or user_id. Example: client@acme.com
- `user_id` (`integer`, optional): Existing user's ID; give this or email. Example: 5678

Example input: `{"project_id":12345}`

### `bugherd_project_member_add`

Add Project Member · Write

Add an existing organization member to a project.
Returns the result.
Use bugherd_project_member_add to give a teammate access. Use bugherd_project_guest_add for clients.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`integer`, required): Project ID, from bugherd_projects_list. Example: 12345
- `user_id` (`integer`, required): Member's user ID, from bugherd_members_list. Example: 4321

Example input: `{"project_id":12345,"user_id":4321}`

### `bugherd_project_update`

Update Project · Write

Update a project's name, website URL or settings; only the fields you send change.
Returns the updated project.
Use bugherd_project_update to rename, deactivate or change sharing.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`integer`, required): Project ID, from bugherd_projects_list. Example: 12345
- `devurl` (`string`, optional): Main website URL. Example: https://www.acme.com
- `guests_see_guests` (`boolean`, optional): Let guests see other guests' feedback. Example: false
- `has_custom_columns` (`boolean`, optional): Whether the project uses custom board columns. Example: true
- `is_active` (`boolean`, optional): Whether the project is active. Example: true
- `is_public` (`boolean`, optional): Enable public feedback, so anyone visiting the site can report issues. Example: false
- `name` (`string`, optional): Project name. Example: Acme website (live)

Example input: `{"project_id":12345}`

### `bugherd_task_create`

Create Task · Write

Create a task (bug or feedback item) in a project; without a status it goes to the Feedback panel.
Returns the created task with its ID and local number.
Use bugherd_task_create to log an issue. Use bugherd_task_update to change it later.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `description` (`string`, required): What the issue is. Example: Header logo is blurry on retina screens
- `project_id` (`integer`, required): Project ID, from bugherd_projects_list. Example: 12345
- `assigned_to_email` (`string`, optional): Email of a project member to assign. Example: dev@yourcompany.com
- `assigned_to_id` (`integer`, optional): User ID to assign; must be a project member. Example: 4321
- `external_id` (`string`, optional): Your ID for the task in another system. Example: JIRA-123
- `priority` (`string`, optional): Priority. One of: not set, critical, important, normal, minor. Example: important. One of: `not set`, `critical`, `important`, `normal`, `minor`.
- `requester_email` (`string`, optional): Email of the person reporting it (any email). Example: client@acme.com
- `requester_id` (`integer`, optional): User ID of the person reporting it. Example: 4321
- `status` (`string`, optional): Column to put it in: backlog, todo, doing, done or a custom column name; leave empty for the Feedback panel. Example: todo
- `tag_names` (`array`, optional): Tags to add. Example: ["homepage", "design"]

Example input: `{"description":"<description>","project_id":12345}`

### `bugherd_task_update`

Update Task · Write

Update a task's description, priority, status (column), assignees, tags or external ID; only the fields you send change.
Returns the updated task.
Use bugherd_task_update to move a task across the board (status todo, doing, done, a custom column or feedback), reassign it or tag it.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`integer`, required): Project ID, from bugherd_projects_list. Example: 12345
- `task_id` (`integer`, required): Task ID (the global task ID returned by the task list tools). Example: 987654
- `assigned_to_email` (`string`, optional): Email of a project member to assign. Example: dev@yourcompany.com
- `assigned_to_id` (`integer`, optional): User ID to assign. Example: 4321
- `description` (`string`, optional): New description. Example: Header logo is blurry on retina screens (iPhone 15)
- `external_id` (`string`, optional): Your ID for the task in another system. Example: JIRA-123
- `priority` (`string`, optional): Priority. One of: not set, critical, important, normal, minor. Example: critical. One of: `not set`, `critical`, `important`, `normal`, `minor`.
- `site` (`string`, optional): Site the task belongs to. Example: https://staging.acme.com
- `status` (`string`, optional): Column: backlog, todo, doing, done, a custom column name, or feedback to send it back to the Feedback panel. Example: doing
- `tag_names` (`array`, optional): Tags; replaces the task's tags. Example: ["homepage"]
- `unassign_user` (`integer`, optional): User ID to remove from the assignees. Example: 8765
- `updater_email` (`string`, optional): Email of the user to credit with the change in the audit trail. Example: dev@yourcompany.com
- `url` (`string`, optional): Page path or URL the task is on. Example: /pricing

Example input: `{"project_id":12345,"task_id":987654}`

### `bugherd_tasks_move`

Move Tasks to Project · Write

Move tasks from one project to another; task IDs stay the same.
Returns the result.
Use bugherd_tasks_move to re-file issues reported on the wrong project. task_ids are the project task numbers (local IDs), not global IDs.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `destination_project_id` (`integer`, required): Project to move the tasks into. Example: 67890
- `project_id` (`integer`, required): Source project ID. Example: 12345
- `task_ids` (`array`, required): Project task numbers (local IDs, the #number) of the tasks to move. Example: [41, 42]

Example input: `{"destination_project_id":67890,"project_id":12345,"task_ids":[41,42]}`

### `bugherd_webhook_create`

Create Webhook · Write

Create a webhook that POSTs to a URL when an event happens, for all projects or one.
Returns the created webhook. A 410 Gone response from your URL removes the webhook automatically.
Use bugherd_webhook_create to sync new tasks or comments into another system.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `event` (`string`, required): Event to send. One of: project_create, task_create, task_update, comment, task_destroy. Example: task_create. One of: `project_create`, `task_create`, `task_update`, `comment`, `task_destroy`.
- `target_url` (`string`, required): URL that receives the events. Example: https://example.com/hooks/bugherd
- `project_id` (`integer`, optional): Only events from this project; leave empty for all projects. Example: 12345

Example input: `{"event":"project_create","target_url":"<target_url>"}`

### `bugherd_attachment_delete`

Delete Attachment · Destructive

Delete an attachment from a task. This cannot be undone.
Returns an empty response on success.
Use bugherd_attachment_delete to remove a file.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `attachment_id` (`integer`, required): Attachment ID, from bugherd_attachments_list. Example: 3141
- `project_id` (`integer`, required): Project ID, from bugherd_projects_list. Example: 12345
- `task_id` (`integer`, required): Task ID (the global task ID returned by the task list tools). Example: 987654

Example input: `{"attachment_id":3141,"project_id":12345,"task_id":987654}`

### `bugherd_project_delete`

Delete Project · Destructive

Delete a project with all its tasks, comments and attachments. This cannot be undone.
Returns an empty response on success.
Use bugherd_project_delete only to remove a project permanently. Use bugherd_project_update with is_active false to archive it.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`integer`, required): Project ID, from bugherd_projects_list. Example: 12345

Example input: `{"project_id":12345}`

### `bugherd_webhook_delete`

Delete Webhook · Destructive

Delete a webhook; BugHerd stops sending its events immediately.
Returns an empty response on success.
Use bugherd_webhook_delete to stop an integration.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `webhook_id` (`integer`, required): Webhook ID, from bugherd_webhooks_list. Example: 777

Example input: `{"webhook_id":777}`

## Related

Other Project Management connectors ([all 67](/agentkit/connectors/?category=project-management)):

- [Notion](/agentkit/connectors/notion/): Scalekit connector, OAuth, 51 tools
- [Linear](/agentkit/connectors/linear/): Scalekit connector, OAuth, 64 tools
- [Airtable](/agentkit/connectors/airtable/): Scalekit connector, OAuth, 26 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
