GET /v1/platform/courses
Returns a paginated list of course generation requests for the authenticated workspace.
Query Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
status | string | - | Filter by status: PENDING, PROCESSING, COMPLETED, or FAILED |
limit | number | 20 | Number of results per page (1-100) |
offset | number | 0 | Number of results to skip |
Example Request
curl "https://api.tutorflow.io/v1/platform/courses?status=COMPLETED&limit=10" \
-H "Authorization: Bearer tf_platform_..."Response
| Field | Type | Description |
|---|---|---|
items | array | Array of course request objects |
total | number | Total number of matching records |
Each item in the items array contains a subset of the full course response fields:
id, status, courseId, title, description, level, tier, editUrl,
previewUrl, isTerminal, createdAt, and completedAt.
Example Response
{
"items": [
{
"id": "a1c2d3e4-f5g6-7h8i-9j0k-l1m2n3o4p5q6",
"status": "COMPLETED",
"courseId": "c7d8e9f0-1a2b-3c4d-5e6f-7g8h9i0j1k2l",
"title": "Python for Beginners",
"tier": "standard",
"editUrl": "https://tutorflow.io/en/platform/courses/edit/51d9b322e680...",
"previewUrl": "https://tutorflow.io/en/platform/courses/b018172542f9...",
"isTerminal": true,
"createdAt": "2025-03-24T12:00:00.000Z",
"completedAt": "2025-03-24T12:00:15.000Z"
}
],
"total": 1
}