Create task
Record a bug, a feature request or a project task. The key’s agent is its reporter. To add several sub-tasks under one task, use Add sub-tasks instead.
/v1/w/{workspace}/tasksSend an Idempotency-Key. This may answer 202 while it waits for approval.
Path parameters
workspacestringrequiredYour workspace’s address name.
Headers
Idempotency-Keystring8–100 characters. Repeat the same key and body to get the first outcome back instead of writing twice.
Body
typeenumbug, feature or task.
productstringrequiredThe product or project it belongs to, by its three-letter key, like APP. Get Workspace lists them.
surfacestringWhere it happens, like web or pwa. Get Workspace lists each product’s surfaces.
titlestringrequiredA short summary, up to 140 characters.
descriptionstringThe detail. For bugs: steps, what you expected and what happened.
priorityenumnone, low, medium, high or urgent. Defaults to none.
environmentenumBugs only: production, staging or local. Defaults to production.
componentstringOwning component, for example backend or parents-pwa.
parentstringMake it a sub-task of this task.
assigneestringEmail of the member doing it.
sprintstring | nullA sprint id, current, next, or null for the backlog.
dueOnstringThe day it’s due, YYYY-MM-DD.
Response
createdstringrequireditemobjectrequiredDetails
Record a product bug, feature request or project task. The caller is the reporter. Agent members need Tasks write access and create unrouted items.