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)
`descriptionHtml`	string	No	Record description as HTML. Sanitized server-side. Do not send with description.
`startedAt`	string	No	Start date. Send a bare YYYY-MM-DD for an all-day date, or ISO 8601 for a timed one.
`duedAt`	string	No	Due date. Send a bare YYYY-MM-DD for an all-day date, or ISO 8601 for a timed one.
`allDay`	boolean	No	Force the dates to be all-day (a floating calendar date shown identically in every timezone) or timed. Usually unnecessary: bare YYYY-MM-DD dates are all-day automatically.
`assigneeIds`	string[]	No	User IDs to assign
`tagIds`	string[]	No	Tag IDs to apply

{
  "workspaceId": "string",
  "title": "string",
  "listId": "string",
  "description": "string",
  "descriptionHtml": "string",
  "startedAt": "string",
  "duedAt": "string",
  "allDay": true,
  "assigneeIds": [
    "string"
  ],
  "tagIds": [
    "string"
  ]
}

Response

{
  "id": "string",
  "uid": "string",
  "title": "string",
  "rank": "string",
  "list": {
    "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","descriptionHtml":"string","startedAt":"string","duedAt":"string","allDay":true,"assigneeIds":["string"],"tagIds":["string"]}'