← Pencil SpacesCONTENT HISTORY

Update to Pencil Spaces

Snapshot Oct 24, 2026 · 12:57 UTC · version 2.0.0

Collection source: downloaded plugin package.

WHAT CHANGED

First saved snapshot

No earlier snapshot is available to establish a change.

Save Pencil Spaces and check future changes in Following.

Up to 3 plugins free · no card required.

Compare saved observations

Download comparison JSON
Full technical diff · 0 changed fields
Full snapshot data
{
  "description": "Use when working with Pencil Spaces data through the pencil-spaces connector — listing or managing an institution's users, virtual classrooms (Spaces), scheduled events, programs, cohorts, sessions, recordings, transcriptions, attendance, availability, sites, custom attributes, alerts, or webhooks. Covers ID formats, base64-encoded filters, custom-attribute syntax, and multi-step workflows (e.g. finding a recording or attendance for a class).",
  "included_files": [
    {
      "relative_path": "references/reference.md",
      "size_in_bytes": 39125
    }
  ],
  "name": "pencil-spaces",
  "skill_md_contents": "---\nname: pencil-spaces\ndescription: Use when working with Pencil Spaces data through the pencil-spaces connector — listing or managing an institution's users, virtual classrooms (Spaces), scheduled events, programs, cohorts, sessions, recordings, transcriptions, attendance, availability, sites, custom attributes, alerts, or webhooks. Covers ID formats, base64-encoded filters, custom-attribute syntax, and multi-step workflows (e.g. finding a recording or attendance for a class).\n---\n\n# Pencil Spaces\n\nPencil Spaces is a virtual-classroom platform. The connector exposes read\ntools for every entity and opt-in write tools (create/update only — nothing\ncan be deleted). For the complete per-tool parameter tables and response\nshapes, read `references/reference.md`.\n\n## Conventions that prevent failed calls\n\n- **IDs**: every `*Id` parameter is a 24-character hex MongoDB ObjectId\n  (`507f1f77bcf86cd799439011`). Never pass names or emails where an ID is\n  expected — look the entity up first.\n- **`filters` parameters are base64-encoded JSON.** Build the JSON object,\n  then pass `base64(JSON.stringify(obj))`. The shape differs per tool —\n  check `references/reference.md` before encoding. Common mistakes: passing\n  raw JSON (must be base64), or nesting `timeRange` wrong for events\n  (`{\"timeRangeStart\": \"...\", \"timeRangeEnd\": \"...\"}` flat keys are\n  accepted and normalized).\n- **Custom attributes** are arrays of `\"keyId:valueId\"` strings — both\n  halves are IDs from `get_attributes`, not display names.\n- **Attendance statuses are Pascal case**: `Present`, `Late`, `Absent`,\n  `Left`, `Excuse` (write) — uppercase variants are rejected.\n- **Availability slots**: `day` is 0–6 (0 = Sunday); times are `HH:mm`\n  24-hour strings when setting, minutes-from-midnight integers when reading.\n- **Dates**: ISO 8601 timestamps; program cancellations use `YYYY-MM-DD`.\n- **Pagination**: `pageNumber` (default 1) and `pageSize` (default 25,\n  max 100) on list tools.\n- **User references** in event/space tools are objects with exactly one of\n  `userId` or `email` — never bare strings.\n\n## Multi-step workflows\n\n- **Recording/transcript of a class**: `list_sessions` (or `list_events` →\n  session) → `get_session` → `get_space_recordings` → `download_recording`\n  (presigned URL) and/or `get_transcription`.\n- **Attendance for a class**: `list_events` (base64 time filter) →\n  `get_attendance` with the eventId. Only past events have attendance.\n- **Who is free at time X**: `get_available_users` with the window, or\n  `get_user_availability` for one person.\n- **Program structure**: `list_programs` → `get_program` → `list_cohorts` /\n  `list_program_cancellations`.\n- **Entity graph**: program → cohorts → events → space → sessions →\n  recordings → transcription. Users belong to sites; attributes tag\n  users/spaces/events.\n\n## Write tools\n\nWrite tools (create/update only) execute only when the connection was\ngranted write access — the user picks \"Read and edit\" on the OAuth consent\nscreen when connecting. If a write call returns \"Write operations are\ndisabled for this connection\", tell the user to reconnect and choose\n\"Read and edit\"; do not retry.\n\nBefore any write, confirm the target with a read (e.g. `get_event` before\n`update_event`). Updates replace provided fields wholesale — for list-valued\nfields (attendees, organizers, cohort members, availability slots) fetch the\ncurrent value, modify it, and send the full list back.\n"
}

SHA-256 of public snapshot: 09cdba961d0961ad0b82f2b7c56049d841f43243a36f480b2890405c08268f3e