# Tasks API

Provides access to the tasks that are part of a Hyperproof organization.

Version: 1.0

## Servers

Hyperproof US
```
https://api.hyperproof.app/v1/tasks
```

Hyperproof Gov
```
https://api.hyperproofgov.app/v1/tasks
```

Hyperproof EU
```
https://api.hyperproof.eu/v1/tasks
```

## Security

### oauth2

Type: oauth2

## Download OpenAPI description

[Tasks API](https://developer.hyperproof.app/_bundle/hyperproof-api/tasks/tasks.openapi.yaml)

## Other

### Add Task

 - [POST /](https://developer.hyperproof.app/hyperproof-api/tasks/tasks.openapi/other/add-task.md): POST /

#### Description

Creates a new task within an organization, initializing its details such as title, description, due dates, and assigned users.

### Get Task

 - [GET /{taskId}](https://developer.hyperproof.app/hyperproof-api/tasks/tasks.openapi/other/get-task.md): GET /{taskId}

#### Description

Retrieves detailed information about a specific task by its ID, including its attributes, status, assignments, and related activity.

### Update Task

 - [PATCH /{taskId}](https://developer.hyperproof.app/hyperproof-api/tasks/tasks.openapi/other/update-task.md): PATCH /{taskId}

#### Description

Updates an existing task with new values, modifying its attributes such as title, description, status, assignee, or due dates.

### Add Task Proof

 - [POST /{taskId}/proof](https://developer.hyperproof.app/hyperproof-api/tasks/tasks.openapi/other/add-task-proof.md): POST /{taskId}/proof

#### Description

Adds a proof item to a task, attaching supporting evidence and its associated metadata for tracking and review.

### Get Task Proof Metadata

 - [GET /{taskId}/proof](https://developer.hyperproof.app/hyperproof-api/tasks/tasks.openapi/other/get-task-proof-meta.md): GET /{taskId}/proof

#### Description

Retrieves metadata for all proof items linked to a specific task, including details such as file information, sources, and upload timestamps.

### Get Tasks Filtered

 - [PUT /filter](https://developer.hyperproof.app/hyperproof-api/tasks/tasks.openapi/other/get-tasks-filtered.md): PUT /filter

#### Description

Retrieves a list of tasks that match the specified filter criteria, such as status, assignee, due date, or category.

### Get Task Comments

 - [GET /{taskId}/comments](https://developer.hyperproof.app/hyperproof-api/tasks/tasks.openapi/other/get-task-comments.md): GET /{taskId}/comments

#### Description

Retrieves all comments from a specified task's Activity Feed, including their content, authors, and timestamps.

### Add Task Comment

 - [POST /{taskId}/comments](https://developer.hyperproof.app/hyperproof-api/tasks/tasks.openapi/other/post-taskid-comments.md): POST /{taskId}/comments

#### Description

Adds a new comment to a task’s Activity Feed, recording the message along with its author and timestamp.

### Update Task Comment

 - [PATCH /{taskId}/comments](https://developer.hyperproof.app/hyperproof-api/tasks/tasks.openapi/other/update-task-comment.md): PATCH /{taskId}/comments?sourceCommentId={sourceCommentId}

#### Description

Updates an existing comment in a task's Activity Feed. The comment is matched based on the sourceCommentId query parameter or body.

### Update Task Comment

 - [PATCH /{taskId}/comments/{commentId}](https://developer.hyperproof.app/hyperproof-api/tasks/tasks.openapi/other/patch-taskid-comments-commentid.md): PATCH /{taskId}/comments/{commentId}

#### Description

Updates an existing comment in a task's Activity Feed, modifying its content or associated metadata.

### Delete Task Comment

 - [DELETE /{taskId}/comments/{commentId}](https://developer.hyperproof.app/hyperproof-api/tasks/tasks.openapi/other/delete-taskid-comments-commentid.md): DEL /{taskId}/comments/{commentId}

#### Description

Deletes a specified comment from a task, permanently removing it from the task’s Activity Feed and history.