Boards
Bulk upsert board items
Create or merge many items in one call.
Each item is fingerprinted and matched against the board's existing items — a match is patched (merging richer fields, bumping last-seen), a miss is created. Keeps scan-merge token cost flat. Requires boards:write.
Request
curl -X POST "https://api.blueticks.co/v1/boards//items/bulk" \ -H "Content-Type: application/json" \ -d '{ "items": [ { "text": "string" } ] }'{
"success": true,
"data": {
"created": [
{
"item_id": "string",
"text": "string",
"status": {
"label": "string",
"bgcolor": "string"
},
"priority": {
"label": "string",
"bgcolor": "string"
},
"due_date": "string",
"cells": {
"property1": "string",
"property2": "string"
},
"source": {
"chat_id": "string",
"chat_name": "string",
"message_key": "string",
"excerpt": "string",
"extracted_at": 0
},
"confidence": 0,
"last_seen_at": 0,
"web_url": "string",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
}
],
"updated": [
{
"item_id": "string",
"text": "string",
"status": {
"label": "string",
"bgcolor": "string"
},
"priority": {
"label": "string",
"bgcolor": "string"
},
"due_date": "string",
"cells": {
"property1": "string",
"property2": "string"
},
"source": {
"chat_id": "string",
"chat_name": "string",
"message_key": "string",
"excerpt": "string",
"extracted_at": 0
},
"confidence": 0,
"last_seen_at": 0,
"web_url": "string",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
}
],
"unchanged": 0,
"board": {
"board_id": "string",
"name": "string",
"description": "string",
"domain": "string",
"web_url": "string"
}
}
}{
"success": false,
"error": {
"code": "string",
"message": "string",
"requestId": "string",
"details": [
{
"path": "string",
"code": "string",
"message": "string"
}
]
}
}Path Parameters
boardId*string
Request Body
application/json
Response
Response Body
application/json
application/json