---
title: "Create new task"
method: POST
path: "/v1/tasks"
tags: ["Tasks"]
---

# Create new task

`POST /v1/tasks`

Creates a new task for the organization

## Request body

- object
  - `title` string, required — Task title
  - `description` string — Task description
  - `model_id` string — Associated model ID
  - `model_file_id` string — Associated model file ID
  - `make_id` string — Associated Make ID
  - `print_job_id` integer — Existing Print Job ID to link through print_jobs.task_id
  - `sku_aliases` string[] — Optional SKU / retail aliases for restock matching
  - `swimlane_id` string — Swimlane ID (defaults to Print Backlog)
  - `priority` 'low' | 'medium' | 'high' — Task priority
  - `tags` string[] — Task tags
  - `assigned_to` string — User ID to assign task to
  - `organizationId` string — Organization ID (optional, defaults to user's primary organization)

## Response `201`

Task created successfully

- object — Task created successfully
  - `task` object

## Other responses

- `400` — Invalid request
- `500` — Internal server error

## Changes

- **2026-09-25** `6f1a23af942d` — 2 info
  - added the new optional request property `print_job_id`
  - added the new optional request property `sku_aliases`

[Change history](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/changes/v1/tasks/post.md)

---

[API](https://skmtc.dev/printhiv3d/apis/hive-api-documentation.md) · [All operations](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/revisions/3dea7fda80a8?raw)