Skip to content
Changelog

Report a bug

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

See How connections work for access and permissions, or browse all integrations.