Update Record

Update fields on an existing record.


POST /v1/update-record

Update fields on an existing record. Only provide the fields you want to change — omitted fields are left unchanged. Use move-record instead to change which list a record is in.

Request body

FieldTypeRequiredDescription
workspaceIdstringYesThe workspace ID the record belongs to
recordIdstringYesThe record ID to update
titlestringNoNew title
descriptionstringNoNew description (plain text)
donebooleanNoSet the done status. Pass true to mark as done, false to mark as not done.
startedAtstringNoStart date (ISO 8601)
duedAtstringNoDue date (ISO 8601)
colorstringNoRecord color
assigneeIdsstring[]NoUser IDs to assign. Replaces all current assignees.
{
  "workspaceId": "string",
  "recordId": "string",
  "title": "string",
  "description": "string",
  "done": true,
  "startedAt": "string",
  "duedAt": "string",
  "color": "string",
  "assigneeIds": [
    "string"
  ]
}

Response

Returns the result of the operation.

Example

curl -X POST https://rest.blue.app/v1/update-record \
  -H "Authorization: Bearer $BLUE_TOKEN" \
  -H "blue-org-id: $BLUE_ORG_ID" \
  -H "Content-Type: application/json" \
  -d '{"workspaceId":"string","recordId":"string","title":"string","description":"string","done":true,"startedAt":"string","duedAt":"string","color":"string","assigneeIds":["string"]}'