Tasks — Create, Update & Delete

Create new items, update column values, delete tasks, and add comments. Use GET /boards/{boardId} to discover column IDs and types before writing field values.

POST/api/access/tasks/boards/{boardId}/itemsBearer Token

Create Item

Create a new item in a board.

Required permission: CreateItems

Path Parameters

Parameter	Type	Description
boardId	string	Target board ID

Query Parameters

Parameter	Type	Default	Description
provider	string	auto	Provider code

Request Body

Field	Type	Required	Description
name	string	Yes	Item name/title
groupId	string?	No	Target group/section within the board
fields	object?	No	Column values \u2014 keys are column IDs, values are provider-specific JSON strings. Use GET /boards/{boardId} to discover column IDs and types.

{ 
  "name": "New task from API", 
  "groupId": "new_group", 
  "fields": { 
    "status": "{\"label\":\"Working on it\"}", 
    "date4": "{\"date\":\"2026-04-15\"}" 
  } 
}

See TaskItemResult for full response schema.

Error Responses

Status	Description
400	name is empty or missing
403	Board not in token scope or create not allowed for this board
502	Provider rejected the creation

PATCH/api/access/tasks/items/{itemId}Bearer Token

Update Item

Update column values on an existing item.

Required permission: UpdateItems

Path Parameters

Parameter	Type	Description
itemId	string	Item ID to update

Query Parameters

Parameter	Type	Default	Description
provider	string	auto	Provider code

Request Body

Field	Type	Required	Description
fields	object	Yes	Column values to update. Key = column ID, Value = provider-specific JSON string. At least one field required.

{ 
  "fields": { 
    "status": "{\"label\":\"Done\"}", 
    "date4": "{\"date\":\"2026-04-20\"}" 
  } 
}

Warning

rejectedFields lists any fields the provider refused to update (e.g. locked columns, invalid values). The operation can still partially succeed \u2014 check both success and rejectedFields.

See TaskItemResult for full response schema.

Error Responses

Status	Description
400	fields is empty
403	ACCESS_DENIED or NO_WRITABLE_FIELDS — update blocked
404	Item not found
502	Provider error

DELETE/api/access/tasks/items/{itemId}Bearer Token

Delete Item

Permanently delete a task item from the provider.

Required permission: DeleteItems

Path Parameters

Parameter	Type	Description
itemId	string	Item ID to delete

Query Parameters

Parameter	Type	Default	Description
provider	string	auto	Provider code

Response 200 OK

{ 
  "provider": "MONDAY", 
  "success": true, 
  "errorCode": null, 
  "errorMessage": null 
}

See TaskOperationResult for full response schema.

Error Responses

Status	Description
403	Delete blocked (ACCESS_DENIED)
404	Item not found
502	Provider error

POST/api/access/tasks/items/{itemId}/commentsBearer Token

Add Comment

Add a comment/update to a task item.

Required permission: AddComments

Path Parameters

Parameter	Type	Description
itemId	string	Item ID to comment on

Query Parameters

Parameter	Type	Default	Description
provider	string	auto	Provider code

Request Body

Field	Type	Required	Description
body	string	Yes	Comment text content

{ 
  "body": "This is ready for review." 
}

See TaskCommentResult for full response schema.

Error Responses

Status	Description
400	body is empty
403	Comment blocked (ACCESS_DENIED)
404	Item not found
502	Provider error

Result Types

TaskItemResult

Returned by Create Item (201) and Update Item (200).

Field	Type	Description
provider	string?	Provider code
success	bool	Whether the operation succeeded
itemId	string?	Created or updated item ID
item	Item?	Full item object (when returned by the provider)
errorCode	string?	Error code: `ACCESS_DENIED`, `NOT_FOUND`, `NO_WRITABLE_FIELDS`
errorMessage	string?	Human-readable error message
rejectedFields	string[]?	Fields the provider refused to update (partial success scenarios)

TaskOperationResult

Returned by Delete Item (200).

Field	Type	Description
provider	string?	Provider code
success	bool	Whether the operation succeeded
errorCode	string?	Error code
errorMessage	string?	Human-readable error message

TaskCommentResult

Returned by Add Comment (201).

Field	Type	Description
provider	string?	Provider code
success	bool	Whether the operation succeeded
commentId	string?	ID of the created comment
errorCode	string?	Error code
errorMessage	string?	Human-readable error message

Permissions Reference

Operation Permissions

Controlled by the token's allowedTaskOperations setting.

Flag	API String	Controls
ViewBoards	`view_boards`	GET /boards, GET /boards/{boardId}
ViewItems	`view_items`	GET /boards/{boardId}/items, GET /items/{itemId}
ViewComments	`view_comments`	Comments included in item responses
CreateItems	`create_items`	POST /boards/{boardId}/items
UpdateItems	`update_items`	PATCH /items/{itemId}
DeleteItems	`delete_items`	DELETE /items/{itemId}
AddComments	`add_comments`	POST /items/{itemId}/comments
ManageGroups	`manage_groups`	Reserved for future use
ReadOnly	`read_only`	Composite: view_boards + view_items + view_comments
All	`all`	All operations