Authenticated endpoints - Plazen Documentation

List notifications

method: GET
path: /api/notifications
summary: List active notifications

Auth: Supabase session required.
Success 200: JSON array where show = true, ordered by created_at desc.
Errors: 401, 500 { error: "Failed to fetch notifications" }.

Tasks collection

method: GET
path: /api/tasks
summary: List tasks for a date (and external events)
queryParams:
  - name: date
    description: YYYY-MM-DD (optional)
  - name: timezoneOffset
    description: Minutes offset from UTC (optional; adjusts serialization)

Generates routine tasks for the date when applicable.
Auth: Session required.
Success 200: JSON of tasks + external events.
Errors: 401, 500.

method: POST
path: /api/tasks
summary: Create a task (auto-scheduling supported)
requestBody:
  - name: title
    required: true
    description: Task title (stored encrypted)
  - name: ...scheduling fields
    required: false
    description: Time info; non-time-sensitive tasks may be auto-slotted

Success: Created task JSON.
Errors: 401, 400/500.

method: PATCH
path: /api/tasks
summary: Update a task (reschedule, complete, rename)
requestBody:
  - name: id
    required: true
  - name: title
    description: Encrypted at rest
  - name: completed
    description: Mark done
  - name: start/end/other scheduling
    description: Reschedule fields

Success: Updated task JSON.
Errors: 401, 400/500.

method: DELETE
path: /api/tasks
summary: Delete a task
requestBody:
  - name: id
    required: true
    description: Task ID (owned by caller)

Success: Deletion confirmation JSON.
Errors: 401, 400/500.

Routine task template

method: PATCH
path: /api/routine-tasks/:id
summary: Update a routine task template
pathParams:
  - name: id
    required: true
requestBody:
  - name: title
    description: Encrypted at rest
  - name: description
  - name: duration_minutes
  - name: is_active

Auth: Session required.
Success 200: Updated routine task (title decrypted in response).
Errors: 401, 500.

method: DELETE
path: /api/routine-tasks/:id
summary: Delete a routine task template
pathParams:
  - name: id
    required: true

Auth: Session required.
Success 200: Deletion success.
Errors: 401, 500.

Username check (introduced in v1.14.0)

method: GET
path: /api/profile/username/check?username=<username>
summary: Check if a username is available and valid

Auth: Supabase session required.
Success 200: { available: boolean, valid: boolean, message?: string }
Errors: 401 { error: "Unauthorized" }, 500 { error: "Failed to check username availability" }.

​List notifications

​Tasks collection

​Routine task template

​Username check (introduced in v1.14.0)

List notifications

Tasks collection

Routine task template

Username check (introduced in v1.14.0)