tasks

List tasks the current user holds or collaborates on across the org (My Work)

Non-milestone tasks assigned to the caller or that the caller collaborates on, on projects the caller owns or is a member of. A row the caller collaborates on but does not hold carries myRole: "collaborator" and assignee (who holds it); a row the caller holds carries neither, as before. Each row also carries hasSubtasks, openSubtaskCount, and isRecurring (§windows-app-b3). All query params are optional and backward compatible.

get/tasks/mine

Request

  • Base URL: https://api.onplana.com/api
  • URL: https://api.onplana.com/api/tasks/mine
  • Auth: one of:
    • HTTP bearer
    • API key in header Authorization

Query parameters

limitinteger

Max rows (default 15, max 1000)

searchstring

Case-insensitive title-contains filter

includeDoneSincestring

YYYY-MM-DD; also include tasks completed on/after this day (Completed section). Malformed value returns 400.

scopestring

assigned (default): tasks the caller holds or collaborates on. managed: every task in the projects the caller manages (owner, or a project role holding project.edit), whoever holds it; such a row the caller is not on carries viaManagedProject: true and assignee. Any other value returns 400.

dueFromstring

YYYY-MM-DD; only tasks due on or after this day (inclusive). Malformed value returns 400.

dueTostring

YYYY-MM-DD; only tasks due on or before this day (inclusive). Malformed value returns 400.

Headers

X-Organization-Idstring required

UUID of the active organization. Sets org context for all scoped operations.

Response

Array of assigned tasks, each with hasSubtasks / openSubtaskCount / isRecurring

Changes

No recorded changes to this operation across all 1 revision of this API.