Assignments and Tasks API Endpoints

The Assignments & Tasks API is the primary interface for reading and mutating everything on a student’s to-do list. Assignments are pulled live from all connected school platforms (Canvas, Google Classroom, StudentVue, Schoology, Blackboard, Moodle) and merged with manual tasks and Notion syncs into a single unified feed. Two distinct endpoints exist for good reason: GET /api/v1/assignments returns only the live platform feed (what the school reports), while GET /api/v1/tasks returns the full merged view including manual tasks — so tools that only care about school deadlines and tools that show everything can each get exactly what they need.

All endpoints under /api/v1/ require authentication. Send your API key as X-API-Key: ip_live_… in the request header. Apply for a key at intelliplan.tech/developers. See Authentication for full details.

GET /api/v1/assignments

Returns the unified assignment list sourced from all connected school platforms. This proxies the /live internal feed — the same data the dashboard renders. Manual tasks and Notion tasks are not included here; use GET /api/v1/tasks for the fully merged view. Required scope: read:assignments

Request
Response

cURL

curl -X GET https://intelliplan.tech/api/v1/assignments \
  -H "X-API-Key: ip_live_YOUR_KEY_HERE"

200 OK

{
  "assignments": [
    {
      "title": "Chapter 5 Reading Quiz",
      "course": "AP Biology",
      "due_date": "2025-02-14",
      "points_possible": 20,
      "priority": "High",
      "source": "canvas"
    },
    {
      "title": "Lab Report Draft",
      "course": "Chemistry",
      "due_date": "2025-02-17",
      "points_possible": 50,
      "priority": "Medium",
      "source": "google_classroom"
    }
  ]
}

assignments

array

Array of assignment objects from all connected school platforms.

Show Assignment object fields

title

string

Assignment name as it appears in the connected LMS.

course

string

Course or class name.

due_date

string

ISO 8601 due date string (e.g. "2025-02-14").

points_possible

number

Maximum points for the assignment. May be null if the LMS does not provide a value.

priority

string

AI-computed priority level: "High", "Medium", or "Low".

source

string

The connected platform this assignment came from (e.g. "canvas", "google_classroom", "studentvue", "moodle", "blackboard", "schoology").

POST /api/v1/tasks — Create a Manual Task

Creates a new manual task owned by the authenticated user. Manual tasks appear on the dashboard alongside school platform assignments and can be synced to Notion if a Notion integration is configured. Required scope: write:tasks

Request
Response

cURL

curl -X POST https://intelliplan.tech/api/v1/tasks \
  -H "X-API-Key: ip_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Review flashcards for midterm",
    "due_date": "2025-02-20",
    "priority": "High",
    "course": "AP Biology",
    "estimated_time": 90,
    "notes": "Focus on cell cycle and mitosis sections"
  }'

201 Created

{
  "status": "ok",
  "task": {
    "id": 4821,
    "title": "Review flashcards for midterm",
    "due_date": "2025-02-20",
    "priority": "High",
    "course": "AP Biology",
    "estimated_time": 90,
    "notes": "Focus on cell cycle and mitosis sections",
    "source": "manual"
  }
}

Request Body

title

string

required

The task title. Must be a non-empty string.

due_date

string

Due date in ISO 8601 format (e.g. "2025-02-20"). Optional; tasks without a due date appear in the Upcoming column.

priority

string

default:"Medium"

Priority level. Accepted values: "High", "Medium", "Low". Defaults to "Medium".

course

string

default:"Personal"

Course or category name to associate this task with. Defaults to "Personal".

estimated_time

integer

default:60

Estimated time to complete the task, in minutes. Defaults to 60.

notes

string

Optional free-text notes or description for the task.

GET /api/v1/tasks — List All Tasks

Returns every task the student has to do — platform assignments, manual tasks, and Notion-synced tasks — in a flat list sorted by urgency. Unlike GET /api/v1/assignments, this calls the /tasks/unified feed and flattens its three buckets (overdue, today, upcoming) into a single array. Each item carries a bucket field indicating which column it belonged to. Required scope: read:assignments

Request
Response

cURL

curl -X GET https://intelliplan.tech/api/v1/tasks \
  -H "X-API-Key: ip_live_YOUR_KEY_HERE"

200 OK

{
  "tasks": [
    {
      "title": "Chapter 5 Quiz",
      "course": "AP Biology",
      "due_date": "2025-02-13",
      "priority": "High",
      "source": "canvas",
      "bucket": "overdue"
    },
    {
      "title": "Review flashcards for midterm",
      "course": "AP Biology",
      "due_date": "2025-02-20",
      "priority": "High",
      "source": "manual",
      "bucket": "upcoming"
    }
  ]
}

tasks

array

Flat array of all tasks, ordered overdue → today → upcoming. Each item includes all assignment fields plus a bucket field.

Show Additional fields

bucket

string

Which urgency column the task belongs to: "overdue", "today", or "upcoming".

source

string

Origin of the task: "canvas", "google_classroom", "studentvue", "moodle", "blackboard", "schoology", "manual", or "notion".

POST /api/v1/assignments/dismiss — Mark as Done

Marks an assignment as dismissed (completed). Dismissed assignments are hidden from the active dashboard view. This action is reversible with the restore endpoint. Required scope: write:tasks

Request Body

title

string

required

The exact title of the assignment to dismiss.

cURL

curl -X POST https://intelliplan.tech/api/v1/assignments/dismiss \
  -H "X-API-Key: ip_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"title": "Chapter 5 Reading Quiz"}'

status

string

"ok" on success.

POST /api/v1/assignments/restore — Un-dismiss

Restores a previously dismissed assignment, returning it to the active dashboard. Use this if a task was marked done by mistake or if the student needs to revisit it. Required scope: write:tasks

Request Body

title

string

required

The exact title of the dismissed assignment to restore.

cURL

curl -X POST https://intelliplan.tech/api/v1/assignments/restore \
  -H "X-API-Key: ip_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"title": "Chapter 5 Reading Quiz"}'

GET /api/v1/tests — List Test Assignments

Returns all assignments that the student has flagged as tests. This is a subset of all assignments — only those where the student explicitly invoked POST /api/v1/tests to mark them as exams or quizzes. Required scope: read:tests

cURL

curl -X GET https://intelliplan.tech/api/v1/tests \
  -H "X-API-Key: ip_live_YOUR_KEY_HERE"

200 OK

{
  "tests": [
    {
      "title": "Midterm Exam",
      "course": "AP Biology",
      "due_date": "2025-03-01"
    }
  ]
}

POST /api/v1/tests — Mark as Test

Flags an existing assignment as a test. The AI scheduler treats tests with higher priority and allocates dedicated review blocks in the generated study plan. Required scope: write:tests

Request Body

title

string

required

The title of the assignment to mark as a test.

cURL

curl -X POST https://intelliplan.tech/api/v1/tests \
  -H "X-API-Key: ip_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"title": "Midterm Exam"}'

DELETE /api/v1/tests — Unmark as Test

Removes the test flag from an assignment. The assignment remains in the regular assignment list; it simply loses its test designation. Required scope: write:tests

Request Body

title

string

required

The title of the test to unmark.

cURL

curl -X DELETE https://intelliplan.tech/api/v1/tests \
  -H "X-API-Key: ip_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"title": "Midterm Exam"}'

Error Responses

All errors across the API follow the same envelope shape, so your error handler only needs to be written once.

Error envelope

{
  "status": "error",
  "error": "invalid_request",
  "message": "title required.",
  "request_id": "a3f1b2c4d5e6f789"
}

Common error codes

Code	HTTP Status	Meaning
`unauthorized`	401	Missing or invalid API key / Bearer token
`insufficient_scope`	403	Key exists but lacks the required scope
`invalid_request`	400	A required field (e.g. `title`) is missing or malformed
`upstream_failed`	502	The connected school platform returned an error
`rate_limited`	429	Too many requests; slow down and retry

Every response carries an X-Request-Id header. If you contact support, share this value — it allows the IntelliPlan team to locate the exact request in logs.

Overview

Endpoints

Developer Tools

Assignments and Tasks API Endpoints

GET /api/v1/assignments

POST /api/v1/tasks — Create a Manual Task

Request Body

GET /api/v1/tasks — List All Tasks

POST /api/v1/assignments/dismiss — Mark as Done

Request Body

POST /api/v1/assignments/restore — Un-dismiss

Request Body

GET /api/v1/tests — List Test Assignments

POST /api/v1/tests — Mark as Test

Request Body

DELETE /api/v1/tests — Unmark as Test

Request Body

Error Responses

Build docs developers (and LLMs) love

Overview

Endpoints

Developer Tools

Documentation Index

​GET /api/v1/assignments

​POST /api/v1/tasks — Create a Manual Task

​Request Body

​GET /api/v1/tasks — List All Tasks

​POST /api/v1/assignments/dismiss — Mark as Done

​Request Body

​POST /api/v1/assignments/restore — Un-dismiss

​Request Body

​GET /api/v1/tests — List Test Assignments

​POST /api/v1/tests — Mark as Test

​Request Body

​DELETE /api/v1/tests — Unmark as Test

​Request Body

​Error Responses

Build docs developers (and LLMs) love

GET /api/v1/assignments

POST /api/v1/tasks — Create a Manual Task

Request Body

GET /api/v1/tasks — List All Tasks

POST /api/v1/assignments/dismiss — Mark as Done

Request Body

POST /api/v1/assignments/restore — Un-dismiss

Request Body

GET /api/v1/tests — List Test Assignments

POST /api/v1/tests — Mark as Test

Request Body

DELETE /api/v1/tests — Unmark as Test

Request Body

Error Responses