# POST /api/tasks

> Tasks - Add New Task

- **Endpoint:** `POST /api/tasks`
- **Group:** Tasks
- **Since:** v1.0.0
- **Defined in:** `RestApi/Controllers/TasksController.php`

## Headers

| Field | Type | Description |
| --- | --- | --- |
| `authtoken` | String | Authentication token, generated from admin area |

## Parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `title` | string | yes | Mandatory Task title |
| `project_id` | number | yes | Mandatory Project ID |
| `assigned_to` | number | yes | Mandatory Assigned user ID |
| `status_id` | number | yes | Mandatory Task status ID |
| `priority_id` | number | yes | Mandatory Task priority ID |
| `description` | string | no | Optional Task description |
| `milestone_id` | number | no | Optional Milestone ID |
| `deadline` | string | no | Optional Deadline (Y-m-d H:i:s) |
| `start_date` | string | no | Optional Start date (Y-m-d H:i:s) |
| `labels` | string | no | Optional Comma-separated label IDs |
| `points` | number | no | Optional Story points (default: 1) |
| `collaborators` | string | no | Optional Comma-separated user IDs |

## Request example

```bash
curl -X POST "https://yoursite.com/index.php/api/tasks" \
  -H "authtoken: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "title": "...", "project_id": "...", "assigned_to": "...", "status_id": "...", "priority_id": "..." }'
```

## Responses

### Success - Success-Response:

```json
HTTP/1.1 200 OK
{
  "status": true,
  "message": "Task add successful."
}
```

---

Part of the [REST API for RISE CRM](https://risecrm.themesic.com/apiguide/) documentation.
Full page: https://risecrm.themesic.com/apiguide/tasks/create-task/