Retrieves tasks from a workspace where the authenticated user has involvement as creator, assignee, assigner, or follower. This endpoint provides a personalized task view filtering the workspace's full task list to show only tasks relevant to the current user, enabling users to quickly access their personal task queue, track assignments they've made, and monitor tasks they're following. Returns a paginated list with cursor-based navigation supporting efficient retrieval of large personal task collections. Use this endpoint when building My Tasks dashboards, personal productivity views, or notification systems that need to show user-specific task lists. For example, call this endpoint to display a user's assigned tasks on their homepage, show tasks they created that need follow-up, or list tasks they're following for status updates. The response includes complete task details (title, description, dates, priority, status, assignee information, custom properties) along with pagination metadata for seamless navigation through large task sets. Supports optional filtering by title for search functionality and flexible sorting by creation date, update date, or other task attributes to organize personal task views.
Key Features:
-
Automatically filters tasks to those where current user is creator, assignee, assigner, or follower for personalized views
-
Returns complete task details including title, description, dates, priority, status, assignee, custom properties, and metadata
-
Supports cursor-based pagination for efficient navigation through large personal task collections
-
Enables title-based filtering for quick task search within user's personal queue
-
Provides flexible sorting options (createdAt, updatedAt, plannedEndDate) for organizing personal task lists
-
Includes count and limit metadata for building pagination UI components
Authorization Logic:
-
User must have view or manage permissions for the specified space (seismic.programs.view or seismic.programs.manage)
-
Only returns tasks where authenticated user has direct involvement (creator/assignee/assigner/follower relationship)
-
Respects task-level access controls and space permissions for proper data isolation
-
Returns 403 if user lacks required view permissions for the space
-
Returns 404 if space does not exist or user has no access
Usage Examples:
Example 1: Get my assigned tasks for today's work
Call GET /v2/spaces/w5PmrE9p0kicqqRSVJ3VBQ/tasks/my?sort=plannedEndDate:asc&limit=50 to retrieve up to 50 tasks where the current user is involved, sorted by due date ascending to prioritize urgent tasks. Use the returned task list to populate a My Tasks widget showing what needs attention today.
Example 2: Search my tasks for specific title keyword
Call GET /v2/spaces/w5PmrE9p0kicqqRSVJ3VBQ/tasks/my?title=presentation&limit=20 to find tasks containing 'presentation' in the title within the user's personal task queue. Useful for quick search functionality in task management interfaces.
Example 3: Paginate through large personal task list
Initial call: GET /v2/spaces/w5PmrE9p0kicqqRSVJ3VBQ/tasks/my?limit=50 returns first 50 tasks and a cursor token. Next page: GET /v2/spaces/w5PmrE9p0kicqqRSVJ3VBQ/tasks/my?cursor=eyJjdXJzb3IiOjUwfQ&limit=50 retrieves the next 50 tasks. Continue until cursor is null.