BugHerd

Delete Column. DELETE /api_v2/projects/{project_id}/columns/{column_id}.json. Permanently deletes a column. This action cannot be undone. A column cannot be deleted if it contains tasks, or if it is the last column in the project.

Delete Project. DELETE /api_v2/projects/{project_id}.json. Permanently deletes the project and all associated data. This action cannot be undone.

Delete Attachment. DELETE /api_v2/projects/{project_id}/tasks/{task_id}/attachments/{attachment_id}.json. Permanently removes the attachment. This action cannot be undone.

Delete Comment. DELETE /api_v2/projects/{project_id}/tasks/{task_id}/comments/{comment_id}.json. Permanently deletes a comment. This action cannot be undone.

Delete task. DELETE /api_v2/projects/{project_id}/tasks/{task_id}.json. Permanently deletes the task. This action cannot be undone.

Delete Webhook. DELETE /api_v2/webhooks/{webhook_id}.json. Removes a webhook subscription. BugHerd will stop sending events to the target URL immediately.

Show Organization. GET /api_v2/organization.json. Returns top-level details about your BugHerd organization, including its name and ID.

List Active Projects. GET /api_v2/projects/active.json. Returns only active projects. This is a convenience shortcut equivalent to filtering the List Projects endpoint by active status.

Show Column. GET /api_v2/projects/{project_id}/columns/{column_id}.json. Returns one taskboard column of a project -- its id, name, owning project and the number of tasks currently in it. BugHerd's own document leaves this operation undescribed; the sentence is authored from its declared 200 response (a single `column` object) and from the list sibling, `GET /api_v2/projects/{project_id}/columns.json`.

List Columns. GET /api_v2/projects/{project_id}/columns.json. Returns all kanban columns for a project. Includes both built-in columns (backlog, todo, doing, done) and any custom columns. > **Known issue:** The `tasks_count` field may return incorrect values (including negative numbers) for some columns.

Show Project. GET /api_v2/projects/{project_id}.json. Returns full details for a single project, including its members, guests, and column configuration.

Show Task by Local ID. GET /api_v2/projects/{project_id}/local_tasks/{local_task_id}.json. Returns a task by its project-scoped local ID (the `#number` shown in the BugHerd UI). This is useful when you have the task number from a URL like `/projects/123/tasks/42`.

List Archived Tasks. GET /api_v2/projects/{project_id}/tasks/archive.json. Returns tasks that have been closed or archived in a project. These tasks no longer appear on the active taskboard.

Show Attachment. GET /api_v2/projects/{project_id}/tasks/{task_id}/attachments/{attachment_id}.json. Returns one attachment on a task -- its id, file name, content type, size and download URL. BugHerd's own document leaves this operation undescribed; the sentence is authored from its declared 200 response (a single `attachment` object) and from the list sibling, `GET /api_v2/projects/{project_id}/tasks/{task_id}/attachments.json`.

List Attachments. GET /api_v2/projects/{project_id}/tasks/{task_id}/attachments.json. Returns all file attachments on a task.

List Comments. GET /api_v2/projects/{project_id}/tasks/{task_id}/comments.json. Returns all comments on a task.

Show Task. GET /api_v2/projects/{project_id}/tasks/{task_id}.json. Returns full details for a single task within a project. Returns complete task details including metadata, browser info, and screenshot data.

List Feedback Tasks. GET /api_v2/projects/{project_id}/tasks/feedback.json. Returns only tasks in the backlog (feedback) column for a project. Use this to review unprocessed bug reports and feedback.

List Tasks. GET /api_v2/projects/{project_id}/tasks.json. Returns tasks for a project. Supports filtering by status, priority, tag, assignee, external ID, and date range.

List Taskboard Tasks. GET /api_v2/projects/{project_id}/tasks/taskboard.json. Returns all active (non-archived) tasks for a project, mirroring what appears on the taskboard in the BugHerd UI.

List Projects. GET /api_v2/projects.json. Returns all projects in your organization, including both active and inactive projects.

Show Task (Global). GET /api_v2/tasks/{task_id}.json. Returns a task by its globally unique ID. Use this when you have a task ID but not the project ID.

List User Projects. GET /api_v2/users/{user_id}/projects.json. Returns all projects that a specific user belongs to. Use `is_active` to filter by project status.

List User Tasks. GET /api_v2/users/{user_id}/tasks.json. Returns all tasks assigned to a specific user across all projects. Supports filtering by date, priority, tag, and assignee.

List Guests. GET /api_v2/users/guests.json. Returns all guest users across your organization. Guests are external collaborators who have been invited to specific projects.

List Users. GET /api_v2/users.json. Returns all users (both team members and guests) in your organization. Use `updated_since` to retrieve only recently changed records.

List Members. GET /api_v2/users/members.json. Returns only team members (non-guest users) in your organization.

List Webhooks. GET /api_v2/webhooks.json. Returns all webhooks configured for your organization. Use this to verify which events are being monitored. Includes delivery statistics and error details.

Add Guest to Project. POST /api_v2/projects/{project_id}/add_guest.json. Adds a guest to a project. Provide either a `user_id` for an existing user or an `email` to send a new invitation.

Add Member to Project. POST /api_v2/projects/{project_id}/add_member.json. Adds one or more existing organization members to a project. The user must already belong to your organization.

Create Column. POST /api_v2/projects/{project_id}/columns.json. Creates a new custom kanban column in a project. The column is appended to the end of the board.

Move Tasks. POST /api_v2/projects/{project_id}/move_tasks.json. Moves one or more tasks from the current project to a different destination project. Task IDs remain the same after the move. **Important:** `task_ids` must contain `local_task_id` values (the project-scoped task number), NOT the globally unique task ID. > **Note:** This endpoint is documented in the BugHerd API but may not be available for all accounts. If you receive a 404 response, contact BugHerd support.

Create Attachment (from URL). POST /api_v2/projects/{project_id}/tasks/{task_id}/attachments.json. Attaches a file to a task by providing a publicly accessible URL. BugHerd downloads the file from the URL and stores a copy. For direct file uploads, use the Upload Attachment endpoint instead.

Create Comment. POST /api_v2/projects/{project_id}/tasks/{task_id}/comments.json. Adds a comment to a task. Identify the commenter by `user_id` or `email`. **Visibility:** Set `is_private: true` to make the comment visible to team members only, not guests/clients.

Create Task. POST /api_v2/projects/{project_id}/tasks.json. Creates a new task in a project. **Requester and assignee:** The requester and assignee can each be specified by user ID or email address. - `assigned_to_email` - the user must be a current project member - `requester_email` - accepts any email address **Status:** Omitting the `status` field or setting it to `null` sends the task to the Feedback panel.

Create Project. POST /api_v2/projects.json. Creates a new project. The project starts with no members or guests -- use the Add Member and Add Guest endpoints to populate the team.

Create Webhook. POST /api_v2/webhooks.json. Creates a new webhook subscription. When the specified event occurs, BugHerd sends a POST request to your `target_url` with the relevant payload. **Supported events:** `project_create`, `task_create`, `task_update`, `comment`, `task_destroy`. Create separate webhook entries for each event type you want to monitor. **Project scope:** Omit `project_id` to receive events for all projects. **Auto-removal:** A `410 Gone` response from your target URL will cause BugHerd to automatically remove the webhook.

Update Column. PUT /api_v2/projects/{project_id}/columns/{column_id}.json. Updates a custom column's name.

Update Project. PUT /api_v2/projects/{project_id}.json. Updates a project's settings. Only include the fields you want to change.

Update Task. PUT /api_v2/projects/{project_id}/tasks/{task_id}.json. Updates one or more fields on a task. Only include the fields you want to change. **Unassigning users:** - Set `assigned_to_id` to `null` to unassign all users - Use `unassign_user` with a user ID to remove a specific user **Moving tasks between columns:** - Set `status` to a column name (e.g. `todo`, `doing`, or a custom column name) - Set `status` to `feedback` to return the task to the Feedback panel **Audit trail:** Include `updater_email` to attribute the change to a specific user. This is for audit purposes only - permissions are not enforced via the API.