API Reference

Partially update a todo

patch
https://integrate.rooflink.com/roof_link_endpoints/api/light/todos//

Partially updates specific fields of an existing todo. Only the fields included in the request body will be updated.

Permission Requirements:

  • The authenticated user must be an employee or crew member.
  • Crew users can only update incomplete todos where they are the assigned user or creator.

Field Restrictions:

  • The job field cannot be updated (it can only be set during creation).
  • The created_by, company, and audit fields are automatically managed.

Auto-generated Behaviors:

  • When a start datetime is provided, an event is created/updated and linked to the todo.
  • Tags are automatically deduplicated.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required

The unique identifier of the todo to update.

Body Params

Request body containing the partial todo data for update.

string
length between 1 and 1000

The name or title of the todo item.

integer

The ID of the user to assign this todo to. Must be a valid user in the company.

string | null

Additional notes or description for the todo.

string
enum

The priority level of the todo.

Allowed:
tags
array of strings

Array of tags for categorization. Custom tags are allowed and will be automatically deduplicated.

tags
date-time | null

Optional event start date and time (ISO 8601 format). When provided, an event is created/updated and linked to this todo.

Responses

Updated 5 months ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 5 months ago