Skip to main content
POST
/
api
/
v1
/
workspaces
/
{workspace_slug}
/
projects
/
{project_id}
/
work-items
Create a work item
curl --request POST \
  --url https://api.plane.so/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/ \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "name": "<string>",
  "description_html": "<string>",
  "state": "<string>",
  "assignees": [
    "<string>"
  ],
  "priority": "<string>",
  "labels": [
    "<string>"
  ],
  "parent": "<string>",
  "estimate_point": "<string>",
  "type": "<string>",
  "module": "<string>",
  "start_date": "<string>",
  "target_date": "<string>"
}
'

Documentation Index

Fetch the complete documentation index at: https://developers.plane.so/llms.txt

Use this file to discover all available pages before exploring further.

​
Path parameters

​
workspace_slug
string
required
The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL https://app.plane.so/my-team/projects/, the workspace slug is my-team.
​
project_id
string
required
The unique identifier of the project.

​
Body parameters

​
name
string
required
Name of the work item.
​
description_html
string
HTML-formatted description of the work item.
​
state
string
ID of the state for the work item.
​
assignees
string[]
Array of user IDs to assign to the work item.
​
priority
string
Priority level. Possible values: none, urgent, high, medium, low.
​
labels
string[]
Array of label IDs to apply to the work item.
​
parent
string
ID of the parent work item.
​
estimate_point
string
Estimate points for the work item (0-7).
​
type
string
ID of the work item type.
​
module
string
ID of the module the work item belongs to.
​
start_date
string
Start date in YYYY-MM-DD format.
​
target_date
string
Target completion date in YYYY-MM-DD format.