API Reference

Create a new todo

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

Creates a new todo item for the authenticated user's company.

Permission Requirements:

  • The authenticated user must be an employee or crew member.
  • The created_by field is automatically set to the authenticated user.
  • The company field is automatically set from the user's company.

Auto-generated Fields:

  • When a start datetime is provided, an event is automatically created and linked to the todo.
  • When a job is specified, additional tags may be auto-added (e.g., "Job" and the job type label).
  • Tags are automatically deduplicated.

Field Restrictions:

  • The job field can only be set during creation and cannot be modified later.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Request body containing the todo data to create.

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.

integer | null

The ID of the job to associate with this todo. This field can only be set during creation.

string
enum
Defaults to M

The priority level of the todo. Defaults to M (Medium) if not specified.

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 automatically created 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