# BugHerd API Documentation

This is the complete API documentation for connecting to the BugHerd API using MindCloud's Universal API.

MindCloud offers one normalized API to access 3,400+ apps from a single place. It centralizes authentication and normalizes app APIs so they are easier and more consistent to use.

## Quickstart

1. A **MindCloud account** — sign in or create an account at [MindCloud](https://app.mindcloud.co).
2. A **MindCloud API Key** — create one in [API Keys](https://app.mindcloud.co/user/api-keys). Keep it on your server.
3. At least one **BugHerd connection** — create or choose one in [Connections](https://app.mindcloud.co/credentials). Note its `connectionId`.

```text
POST https://connect.mindcloud.co/v2/universal/apps/bugHerd/actions/{actionSlug}/run
```

## BugHerd actions

- POST `add-project-client` Add Project Client
- POST `add-project-member` Add Project Member
- POST `create-attachment-from-url` Create Attachment From URL
- POST `create-column` Create Column
- POST `create-comment` Create Comment
- POST `create-project` Create Project
- POST `create-task` Create Task
- POST `create-webhook` Create Webhook
- DELETE `delete-attachment` Delete Attachment
- DELETE `delete-project` Delete Project
- DELETE `delete-webhook` Delete Webhook
- GET `list-active-projects` List Active Projects
- GET `list-archived-tasks` List Archived Tasks
- GET `list-attachments` List Attachments
- GET `list-clients` List Clients
- GET `list-columns` List Columns
- GET `list-comments` List Comments
- GET `list-feedback-tasks` List Feedback Tasks
- GET `list-members` List Members
- GET `list-projects` List Projects
- GET `list-taskboard-tasks` List Taskboard Tasks
- GET `list-tasks` List Tasks
- GET `list-user-projects` List User Projects
- GET `list-user-tasks` List User Tasks
- GET `list-users` List Users
- GET `list-webhooks` List Webhooks
- GET `show-attachment` Show Attachment
- GET `show-column` Show Column
- GET `show-organization` Show Organization
- GET `show-project` Show Project
- GET `show-task-by-global-id` Show Task By Global ID
- GET `show-task-by-local-task-id` Show Task By Local Task ID
- GET `show-task-by-project-id` Show Task By Project ID
- PUT `update-column` Update Column
- PUT `update-project` Update Project
- PUT `update-task` Update Task
- POST `upload-attachment` Upload Attachment