OlammaAPI
Menu

Update task

Change a task’s status, priority, assignee, due date, title or other details, or add a note to its history. Send only what changes. Send expectedVersion to make sure nobody changed it since you read it.

PATCH/v1/w/{workspace}/tasks/{id}

Send an Idempotency-Key. This may answer 202 while it waits for approval.

Path parameters

workspacestringrequired

Your workspace’s address name.

idstringrequired

The task’s id, like APP-12.

Headers

Idempotency-Keystring

8–100 characters. Repeat the same key and body to get the first outcome back instead of writing twice.

Body

statusenum

open, in_progress, to_test, do_later, done or wont_do.

priorityenum

none, low, medium, high or urgent. Defaults to none.

assigneestring

Email of the member doing it, or an empty string to clear.

titlestring

A short summary, up to 140 characters.

descriptionstring

The detail. For bugs: steps, what you expected and what happened.

productstring

The product or project it belongs to, by its three-letter key, like APP. Get Workspace lists them.

surfacestring

Where it happens, like web or pwa. Get Workspace lists each product’s surfaces.

environmentenum

Bugs only: production, staging or local. Defaults to production.

componentstring | null
expectedVersionstring

The updatedAt from your last read. If it changed since, nothing is written and you get conflict with the current task.

notestring

A note added to the task’s history, such as what you found or did.

parentstring | null

Make it a sub-task of this task.

milestonestring | null

Project milestone id, or null to clear.

sprintstring | null

A sprint id, current, next, or null for the backlog.

dueOnstring | null

The day it’s due, YYYY-MM-DD.

closeSubtasksenum

When closing a task: done or wont_do also closes its unfinished sub-tasks.

Response

updatedstringrequired
itemobjectrequired

Details

Change status, priority, assignee, due date, title, description, product, surface, environment or parent, or add a note. Every change is written to the item's activity with the caller as actor. Starting a sub-task also starts its parent when the parent is open.

Since 2026-12. Errors are listed in Errors.