Create Record - Blue API

POST /v1/create-record

Create a new record (task/item) in a workspace. Requires a workspaceId from list-workspaces. Optionally place it in a specific list (use list-lists to get list IDs), assign users, and apply tags.

Request body

Field	Type	Required	Description
`workspaceId`	string	Yes	The workspace ID to create the record in
`title`	string	Yes	Record title
`listId`	string	No	List ID to place the record in. If omitted, uses the first list.
`description`	string	No	Record description (plain text)
`assigneeIds`	string[]	No	User IDs to assign
`tagIds`	string[]	No	Tag IDs to apply

{
  "workspaceId": "string",
  "title": "string",
  "listId": "string",
  "description": "string",
  "assigneeIds": [
    "string"
  ],
  "tagIds": [
    "string"
  ]
}

Response

{
  "id": "string",
  "uid": "string",
  "title": "string",
  "position": 0,
  "todoList": {
    "id": "string",
    "title": "string"
  }
}

Example

curl -X POST https://rest.blue.app/v1/create-record \
  -H "Authorization: Bearer $BLUE_TOKEN" \
  -H "blue-org-id: $BLUE_ORG_ID" \
  -H "Content-Type: application/json" \
  -d '{"workspaceId":"string","title":"string","listId":"string","description":"string","assigneeIds":["string"],"tagIds":["string"]}'