Bugherd integration: operations for AI agents
Bugherd connects to Type.com as an integration. This page lists the 41 operations documented for Claude and Codex in Type.com: 22 read, 11 write, 8 destructive.
About Bugherd
BugHerd vendor API references, subject to account permissions.
Categories: Productivity & Project Management
How to connect Bugherd to Type.com
- Access
- Organization connection: one shared account for the workspace.
To add the connection, follow the steps in Space connections.
Documented operations
41 operations. Your connection's permissions determine which operations are available. API references describe the vendor surface; they do not expand your connection's credentials or access.
41 operations listed.
- Read
Show Organization
Returns top-level details about your BugHerd organization, including its name and ID.
GET /api_v2/organization.json - Read
List Users
Returns all users (both team members and guests) in your organization. Use `updated_since` to retrieve only recently changed records.
GET /api_v2/users.json - Read
List Members
Returns only team members (non-guest users) in your organization.
GET /api_v2/users/members.json - Read
List Guests
Returns all guest users across your organization. Guests are external collaborators who have been invited to specific projects.
GET /api_v2/users/guests.json - Read
List User Tasks
Returns all tasks assigned to a specific user across all projects. Supports filtering by date, priority, tag, and assignee.
GET /api_v2/users/{user_id}/tasks.json - Read
List User Projects
Returns all projects that a specific user belongs to. Use `is_active` to filter by project status.
GET /api_v2/users/{user_id}/projects.json - Read
List Projects
Returns all projects in your organization, including both active and inactive projects.
GET /api_v2/projects.json - Read
List Active Projects
Returns only active projects. This is a convenience shortcut equivalent to filtering the List Projects endpoint by active status.
GET /api_v2/projects/active.json - Read
Show Project
Returns full details for a single project, including its members, guests, and column configuration.
GET /api_v2/projects/{project_id}.json - Read
List Tasks
Returns tasks for a project. Supports filtering by status, priority, tag, assignee, external ID, and date range.
GET /api_v2/projects/{project_id}/tasks.json - Read
List Feedback Tasks
Returns only tasks in the backlog (feedback) column for a project. Use this to review unprocessed bug reports and feedback.
GET /api_v2/projects/{project_id}/tasks/feedback.json - Read
List Archived Tasks
Returns tasks that have been closed or archived in a project. These tasks no longer appear on the active taskboard.
GET /api_v2/projects/{project_id}/tasks/archive.json - Read
List Taskboard Tasks
Returns all active (non-archived) tasks for a project, mirroring what appears on the taskboard in the BugHerd UI.
GET /api_v2/projects/{project_id}/tasks/taskboard.json - Read
Show Task (Global)
Returns a task by its globally unique ID. Use this when you have a task ID but not the project ID.
GET /api_v2/tasks/{task_id}.json - Read
Show Task
Returns full details for a single task within a project. Returns complete task details including metadata, browser info, and screenshot data.
GET /api_v2/projects/{project_id}/tasks/{task_id}.json - Read
Show Task by Local ID
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`.
GET /api_v2/projects/{project_id}/local_tasks/{local_task_id}.json - Read
List Columns
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.
GET /api_v2/projects/{project_id}/columns.json - Read
Show Column
Show Column
GET /api_v2/projects/{project_id}/columns/{column_id}.json - Read
List Comments
Returns all comments on a task.
GET /api_v2/projects/{project_id}/tasks/{task_id}/comments.json - Read
List Attachments
Returns all file attachments on a task.
GET /api_v2/projects/{project_id}/tasks/{task_id}/attachments.json - Read
Show Attachment
Show Attachment
GET /api_v2/projects/{project_id}/tasks/{task_id}/attachments/{attachment_id}.json - Read
List Webhooks
Returns all webhooks configured for your organization. Use this to verify which events are being monitored. Includes delivery statistics and error details.
GET /api_v2/webhooks.json - Write
Create Project
Creates a new project. The project starts with no members or guests -- use the Add Member and Add Guest endpoints to populate the team.
POST /api_v2/projects.json - Write
Add Member to Project
Adds one or more existing organization members to a project. The user must already belong to your organization.
POST /api_v2/projects/{project_id}/add_member.json - Write
Add Guest to Project
Adds a guest to a project. Provide either a `user_id` for an existing user or an `email` to send a new invitation.
POST /api_v2/projects/{project_id}/add_guest.json - Write
Create Task
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.
POST /api_v2/projects/{project_id}/tasks.json - Write
Move Tasks
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.
POST /api_v2/projects/{project_id}/move_tasks.json - Write
Create Column
Creates a new custom kanban column in a project. The column is appended to the end of the board.
POST /api_v2/projects/{project_id}/columns.json - Write
Update Column
Updates a custom column's name.
PUT /api_v2/projects/{project_id}/columns/{column_id}.json - Write
Create Comment
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.
POST /api_v2/projects/{project_id}/tasks/{task_id}/comments.json - Write
Create Attachment (from URL)
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.
POST /api_v2/projects/{project_id}/tasks/{task_id}/attachments.json - Write
Upload Attachment
Uploads a file directly to a task using multipart form data. **When to use:** Use this when you have the file locally. Use Create Attachment (from URL) when the file is already hosted online. **Limits:** Maximum request duration is approximately 30 seconds. For larger files, use the URL-based Create Attachment endpoint instead.
POST /api_v2/projects/{project_id}/tasks/{task_id}/attachments/upload - Write
Create Webhook
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.
POST /api_v2/webhooks.json - Destructive
Update Project
Updates a project's settings. Only include the fields you want to change.
PUT /api_v2/projects/{project_id}.json - Destructive
Delete Project
Permanently deletes the project and all associated data. This action cannot be undone.
DELETE /api_v2/projects/{project_id}.json - Destructive
Update Task
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.
PUT /api_v2/projects/{project_id}/tasks/{task_id}.json - Destructive
Delete task
Permanently deletes the task. This action cannot be undone.
DELETE /api_v2/projects/{project_id}/tasks/{task_id}.json - Destructive
Delete Column
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 /api_v2/projects/{project_id}/columns/{column_id}.json - Destructive
Delete Comment
Permanently deletes a comment. This action cannot be undone.
DELETE /api_v2/projects/{project_id}/tasks/{task_id}/comments.json - Destructive
Delete Attachment
Permanently removes the attachment. This action cannot be undone.
DELETE /api_v2/projects/{project_id}/tasks/{task_id}/attachments/{attachment_id}.json - Destructive
Delete Webhook
Removes a webhook subscription. BugHerd will stop sending events to the target URL immediately.
DELETE /api_v2/webhooks/{webhook_id}.json
No operations match.
See How connections work for access and permissions, or browse all integrations.