Skip to navigation
PlatformProject Items

API · Items · Create a project item

View as Markdown

Create a new item within the project. The accepted fields vary by resourcetype — inspect a GET response to see available fields for the target type.

Authentication

AuthorizationApi-Key

Header authentication of the form Api-Key <token>

OR
AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

resourcetypestringRequired
Project type selector
parent_lookup_project_idstringRequired
Parent project ID

Request

This endpoint expects an object.
titlestringOptional

Item title (defaults to "Untitled Task" if omitted)

descriptionstringOptional
Optional item description
primary_typestringOptional

Free-form item category string

datamap from strings to anyOptional

Flexible JSON data for this item. Base schema has assets (list of asset IDs) and flags (Dict[str,bool]) but accepts any additional fields.

start_datedatetimeOptional
Optional start date
due_datedatetimeOptional
Optional due date
statusstringOptional

Optional status string (max 16 chars)

priorityintegerOptional

Priority level (default 0)

Response

Item created

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error