Skip to main content
Bugherd logo
  • Category: project management
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 26
  • Triggers: 0
  • Slug: BUGHERD
  • Version: 20261101_00

Tools

Slug: BUGHERD_ADD_GUEST_TO_PROJECTTool to add a guest (client) to a project. Use when you want to add an existing client by ID or invite a new client by email.

Input Parameters

string
Email address to invite a new guest (client). Mutually exclusive with ‘user_id’.
integer
ID of an existing guest (client) to add. Mutually exclusive with ‘email’.
integer
required
ID of the project to add the guest (client) to.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUGHERD_ADD_MEMBER_TO_PROJECTTool to add a member to a project in BugHerd. Use when you need to add an existing user to a specific project.

Input Parameters

integer
required
The ID of the existing user to add to the project.
integer
required
The ID of the project to which the member will be added.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUGHERD_CREATE_ATTACHMENTTool to add a new attachment to a task using an existing URL. Use when you have project and task IDs and the external file URL ready.

Input Parameters

string
required
Public URL of the file to attach.
integer
required
Unique identifier of the task to which the attachment will be added.
string
required
Name of the attachment file (e.g., ‘resolution.gif’).
integer
required
Unique identifier of the project containing the task.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUGHERD_CREATE_COLUMNTool to create a new column in a project. Use when you need to add a custom workflow column after identifying the project ID.

Input Parameters

string
required
Name of the new custom column.
integer
Zero-based position of the new column in the project’s column list; defaults to appending if omitted.
integer
required
ID of the project to which the column will be added.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUGHERD_CREATE_COMMENTTool to add a new comment to a task. Use when you need to record discussion or feedback on an existing task.

Input Parameters

string
required
Content of the comment to add.
string
Email address of the commenter. Used if ‘user_id’ is not set.
integer
required
ID of the task to which the comment will be added.
integer
ID of an existing user adding the comment. Mutually exclusive with ‘email’.
integer
required
ID of the project containing the task.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUGHERD_CREATE_PROJECTTool to create a new project. Use when you need to initialize a project after gathering its name and URL. Example: “Create a new project named ‘My Website’ with URL ‘http://www.example.com’.”

Input Parameters

object
required
Project fields for creating a new BugHerd project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUGHERD_CREATE_TASKTool to add a new task in a project. Use when you have the project ID and full task details ready.

Input Parameters

string
Status or column for the task. Use one of the default statuses (‘backlog’,‘todo’,‘doing’,‘done’,‘closed’) or for custom columns pass the column name. Omit or set to null to send to the Feedback panel.
string ("not set" | "critical" | "important" | "normal" | "minor")
Priority of the task. Defaults to ‘not set’ if omitted.
array
List of tag strings to associate with the new task.
integer
required
ID of the project to which the task will be added.
string
required
Text describing the task or bug to be logged.
string
API-only field for correlating with external systems. Cannot be set from the BugHerd UI.
integer
ID of an existing requester user. Mutually exclusive with ‘requester_email’.
integer
ID of a project member to assign this task to. Mutually exclusive with ‘assigned_to_email’.
string
Email address of the requester. Used if ‘requester_id’ is not set.
string
Email of a project member to assign this task to. Must correspond to an existing member in the given project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUGHERD_CREATE_WEBHOOKTool to create a new webhook for real-time event notifications. Use when you need to configure a callback endpoint for task or comment events. Example: “Create a webhook for ‘task_create’ events to be sent to ‘https://example.com/webhook’.”

Input Parameters

string ("task_create" | "task_update" | "comment" | "task_destroy")
required
Event that triggers the webhook. One of ‘task_create’, ‘task_update’, ‘comment’, or ‘task_destroy’.
integer
ID of the project to apply the webhook to. If omitted, applies to all projects.
string
required
URL to which webhook payloads will be delivered.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUGHERD_DELETE_PROJECTTool to delete a project. Use when you need to permanently remove a project and its associated data. This action cannot be undone, so confirm the project ID before calling.

Input Parameters

integer
required
The ID of the project to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUGHERD_LIST_ACTIVE_PROJECTSList active projects in your BugHerd account, one page at a time. Use the pagination metadata to help retrieve the complete list for syncing or reporting.

Input Parameters

integer
Page number for pagination (1-based). BugHerd returns up to 100 records per page; omit to fetch the first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUGHERD_LIST_ATTACHMENTSList attachments for a task in a project, one page at a time. The response includes pagination metadata.

Input Parameters

integer
Page number for pagination (each page returns up to 100 attachments).
integer
required
Global unique ID of the task to list attachments for (not the local_task_id).
integer
required
ID of the project containing the task.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUGHERD_LIST_COLUMNSTool to list all columns for a project. Use when you need the full set of default and custom columns for a project.

Input Parameters

integer
required
The unique identifier of the BugHerd project. Obtain this from the List Projects action.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUGHERD_LIST_PROJECTSRetrieve a paginated list of projects in your BugHerd account, with pagination metadata including the total count. Project summaries include ID, name, creation date, owner, whether the project has tasks, and associated website URLs.

Input Parameters

integer
Page number for pagination. Each page returns up to 100 projects. Defaults to 1 if not specified.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUGHERD_LIST_PROJECT_TASKSTool to list tasks within a specific BugHerd project with optional server-side filters (status/column, assignee, tag, priority, date filters) and pagination. Use when you need to retrieve tasks scoped to a single project.

Input Parameters

string
Filter by tag name.
integer
Page number for pagination. Each page returns up to 100 tasks. Defaults to 1 if not specified.
string
Filter by status or column name (e.g., ‘backlog’, ‘todo’, ‘doing’, ‘done’, ‘closed’, or custom column name).
string
Filter by priority level (e.g., ‘critical’, ‘important’, ‘normal’, ‘minor’, ‘not set’).
integer
required
ID of the project to list tasks from.
string
Filter by external ID for integration with external systems.
string
Filter tasks created since this timestamp (ISO8601 format).
string
Filter tasks updated since this timestamp (ISO8601 format).
integer
Filter by assigned user ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUGHERD_LIST_USERSTool to list all users in your account. Use after authenticating to fetch the current user roster. Supports pagination via the page parameter.

Input Parameters

integer
Page number (1-based) to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUGHERD_LIST_WEBHOOKSTool to list all installed webhooks. Use when you need to audit or verify existing webhooks after setup.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUGHERD_SHOW_ATTACHMENTTool to retrieve details of a specific attachment. Use after you have project_id, task_id, and attachment_id to get filename, URL, and timestamps.

Input Parameters

integer
required
Unique identifier of the task containing the attachment.
integer
required
Unique identifier of the project containing the task.
integer
required
Unique identifier of the attachment to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUGHERD_SHOW_COLUMNTool to show details of a specific column. Use when you need metadata for a particular column within a project.

Input Parameters

integer
required
Unique identifier of the column to retrieve
integer
required
ID of the project containing the column

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUGHERD_SHOW_ORGANIZATIONTool to retrieve your BugHerd organization details. Use after authenticating to fetch account metadata.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUGHERD_SHOW_PROJECTRetrieves full details of a specific BugHerd project by ID. Returns comprehensive project information including name, settings, team members, guests, and kanban columns. Use this when you need detailed project data such as member lists, workflow columns, or project configuration settings. Requires a valid project_id obtained from list_projects or another source.

Input Parameters

integer
required
The unique identifier of the project to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUGHERD_SHOW_USER_PROJECTSLists projects a specific user has access to by user ID. Supports pagination via the page parameter; each request returns one page.

Input Parameters

integer
Page number for pagination. Each page returns up to 100 projects. Defaults to page 1 if not specified.
integer
required
The unique ID of the user whose accessible projects you want to list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUGHERD_SHOW_USER_TASKSRetrieves all tasks created by or assigned to a specific user, grouped by project. Returns task details including ID, description, priority, status, timestamps, and tags. Requires a valid user_id (obtain from List Users action). Supports pagination via page parameter.

Input Parameters

integer
Pagination page number (each page returns up to 100 tasks).
integer
required
Globally unique ID of the user whose tasks to list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUGHERD_UPDATE_COLUMNTool to update a column in a project. Use when you have the project and column IDs and need to rename a column. Use after confirming the correct IDs.

Input Parameters

object
required
Column fields to update
integer
required
ID of the column to update
integer
required
ID of the project containing the column

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUGHERD_UPDATE_PROJECTUpdate settings for an existing BugHerd project. Use this to modify a project’s name, URL, visibility settings, or guest permissions. Prerequisites: You need a valid project_id. Use list_projects to find existing project IDs, or create_project to create a new one. Note: Only include fields you want to change - omitted fields will retain their current values.

Input Parameters

object
required
Object containing the fields to update. Only include the fields you want to change.
integer
required
The unique numeric ID of the project to update. Get this from list_projects or create_project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUGHERD_UPDATE_TASKTool to update a task in a project. Use after confirming the project and task IDs.

Input Parameters

object
required
Fields to update for the task
integer
required
Global ID of the task to update (not the local_task_id)
integer
required
ID of the project containing the task

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUGHERD_UPLOAD_ATTACHMENTTool to upload a new attachment and add it to a specific task. Use when you have binary file content ready and need to attach it to a BugHerd task.

Input Parameters

integer
required
ID of the task to attach the file to.
string
required
Name of the attachment file including extension (e.g., ‘screenshot.png’, ‘report.pdf’).
integer
required
ID of the project containing the task.
string
required
Raw binary content of the file to be uploaded. For text files, encode the content as bytes.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not