studium

name	studium
description	Interact with Uppsala University's Studium (Canvas LMS) via REST API. Use for managing courses, viewing assignments, checking submissions, grading, posting announcements, and viewing student rosters. Requires STUDIUM_API_KEY environment variable.

Studium (Canvas LMS) Skill

Uppsala University's learning management system, based on Canvas LMS.

Setup

The skill will automatically find your API key from multiple sources:

1. Environment variable (if set):

export STUDIUM_API_KEY="your-api-key-here"

2. .env.studium file in your workspace (recommended):

# Create/edit .env.studium
STUDIUM_API_KEY=your-api-key-here

3. Command line (for one-off usage):

scripts/studium.py courses --token your-api-key-here

The skill automatically searches for .env.studium in:

• Current directory
• ~/.openclaw/workspace/
• The skill's workspace directory

Base URL

All requests go to: https://uppsala.instructure.com/api/v1/

Quick Reference

List your courses

scripts/studium.py courses

Get course details

scripts/studium.py course <course_id>

List assignments in a course

scripts/studium.py assignments <course_id>

List submissions for an assignment

scripts/studium.py submissions <course_id> <assignment_id>

Get student roster

scripts/studium.py students <course_id>

Post an announcement

scripts/studium.py announce <course_id> "Title" "Message body"

List ungraded submissions

scripts/studium.py ungraded <course_id>

Grade a submission

scripts/studium.py grade <course_id> <assignment_id> <user_id> <score> ["comment"]

Download all submissions for an assignment

scripts/studium.py download <course_id> <assignment_id> [output_dir]

Common Workflows

Check what needs grading

# List all courses
scripts/studium.py courses

# Check ungraded for a specific course
scripts/studium.py ungraded <course_id>

Bulk download submissions

scripts/studium.py download <course_id> <assignment_id> ./submissions/

View upcoming deadlines

scripts/studium.py assignments <course_id> --upcoming

API Authentication

All requests use Bearer token auth:

Authorization: Bearer <STUDIUM_API_KEY>

Rate Limits

Canvas has rate limits. The script handles pagination automatically. For bulk operations, expect ~10 requests/second max.

Troubleshooting

• 401 Unauthorized: Check API key is valid and not expired
• 403 Forbidden: You don't have permission for this course/resource
• 404 Not Found: Course/assignment ID doesn't exist or you lack access