Skip to main content
POST
https://api.plane.so
/
api
/
v1
/
workspaces
/
{workspace_slug}
/
projects
/
{project_id}
/
work-items
/
{work_item_id}
/
work-item-properties
/
{property_id}
/
values
Add custom property values
curl --request POST \
  --url https://api.plane.so/api/v1/workspaces/{workspace_slug}/projects/{project_id}/work-items/{work_item_id}/work-item-properties/{property_id}/values/ \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "value": [
    {}
  ]
}
'

​
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.
​
work_item_id
string
required
The unique identifier for the work item.
​
property_id
string
required
The unique identifier for the custom property.

​
Body parameters

​
value
string | boolean | number | string[]
required
The value type depends on the property type:
  • TEXT/URL/EMAIL/FILE: string
  • DATETIME: string (YYYY-MM-DD or YYYY-MM-DD HH:MM:SS)
  • DECIMAL: number (int or float)
  • BOOLEAN: boolean (true/false)
  • OPTION/RELATION (single): string (UUID)
  • OPTION/RELATION (multi, when is_multi=True): list of strings (UUIDs) or single string
For multi-value properties (is_multi=True):
  • Accept either a single UUID string or a list of UUID strings
  • Multiple records are created
  • Response will be a list of values
For single-value properties:
  • Only one value is allowed per work item/property combination