List todos

get

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

Retrieves a paginated list of todos for the authenticated user's company.

Permission Requirements:

Employee users: Can access all todos in their company.
Crew users: Can only access incomplete todos where they are the assigned user or creator.

Filtering and Search:

The endpoint supports multiple filter parameters to narrow down results by priority, tags, assigned user, associated job, completion status, and date ranges. Use the search parameter to perform case-insensitive searches on todo names.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

page

integer

≥ 1

Defaults to 1

Page number for pagination. Each page contains up to 250 results.

page_size

integer

1 to 250

Defaults to 250

Number of results per page. Maximum and default value is 250.

string

Case-insensitive search filter for todo names. Matches todos whose name field contains the specified text.

priority

string

enum

Filter todos by priority level. Must be one of: L (Low), M (Medium), H (High), or U (Urgent).

Allowed:

200Todos retrieved successfully. Returns a paginated list of todos with user and job information.

400Bad Request. Invalid query parameters were provided. This can occur if the page number is invalid, page_size exceeds the maximum, filter parameters contain invalid values, or date formats are incorrect.

401Unauthorized. Authentication credentials were not provided or are invalid. The request must include a valid API key in the X-API-KEY header to access this endpoint.

403Forbidden. The authenticated user does not have the required permissions to access todos. This endpoint is restricted to employees and crew members only.

429Too Many Requests. The client has exceeded the rate limit for this endpoint. Wait for the specified time period before making additional requests.

503Service Unavailable. The API rate limits for all public endpoints have been exceeded, or the service is temporarily down for maintenance. Try again later.