API Reference

Update a todo

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

Updates all fields of an existing todo. This is a full update operation that replaces the entire todo.

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 complete todo data for update.

string
required
length between 1 and 1000

The name or title of the todo item.

integer
required

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
Defaults to M

The priority level of the todo.

Allowed:
tags
array of strings
Defaults to

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