List my work

GET

/my-work

GET

/my-work

1 curl https:/https://api/my-work \
2      -H "Authorization: Bearer <token>" \
3      -H "Content-Type: application/json"

1 {
2   "tasks": [
3     {
4       "id": "task_9f8b7c6d",
5       "title": "Review Q2 Marketing Plan",
6       "status": "in-progress",
7       "priority": "high",
8       "dueDate": "2024-06-10T17:00:00Z",
9       "assignedTo": "jane.doe@example.com",
10       "playbookRunId": "run_4a3b2c1d",
11       "projectId": "proj_12345",
12       "createdAt": "2024-05-01T09:30:00Z",
13       "updatedAt": "2024-05-15T14:45:00Z",
14       "details": {
15         "description": "Ensure all sections are complete and aligned with company goals.",
16         "checklist": [
17           "Review budget allocations",
18           "Verify timelines",
19           "Confirm resource assignments"
20         ]
21       }
22     }
23   ],
24   "nextCursor": "eyJ0YXNrSWQiOiJ0YXNrXzlmOGI3YzZkIiwicHJpb3JpdHkiOiJoZWlnaCJ9"
25 }

Returns the caller’s actionable tasks across every run they can access, keyset-paginated and sorted by urgency.

Authentication

AuthorizationBearer

WorkOS session JWT or an organization API key, sent as Authorization: Bearer <token>.

Query parameters

statusenumOptional

Filter to a single task status.

playbookSlugstringOptional

Filter to tasks belonging to runs of this playbook.

projectIdstringOptional

Filter to tasks in this project.

limitintegerOptional1-100Defaults to 50

Maximum number of tasks to return.

cursorstringOptional

Keyset cursor from a previous page’s nextCursor.

Response

The caller's actionable tasks.

taskslist of maps from strings to any

nextCursorstring or null

Keyset cursor for the next page, or null.

Errors

400

Bad Request Error

401

Unauthorized Error