Castify (Screencastify)

# Get Auth Context Fetch the current authenticated context (user identity, organizations, roles, and accessible resources). ## CRITICAL INSTRUCTIONS - **Always call this tool first** if you need to look up an organization ID by name, as many other tools (like search) require an organization ID. - **Organization Token Note:** When using an organization token, there will be no "user" metadata present in the response.

get_auth_context

# Create Folder Creates a new folder to help organize videos. Optionally nests it inside an existing folder and/or moves a set of videos into it immediately. ## CRITICAL CONTEXT RULES 1. **User Context Only:** Folders are always owned by the authenticated user, so this tool can only be used when operating on behalf of a specific user. Organization API keys (which have no specific user) cannot create folders. 2. **Parent Folder Ownership:** If `parentFolderId` is provided, it must be a folder owned by the authenticated user; this is enforced automatically. 3. **Video Ownership:** Every video listed in `videoIds` must be owned by the authenticated user; this is also enforced automatically. Use `execute_search` with `ownerId` set to your own user ID first if you need to confirm which videos you own.

create_folder

# Export Video Starts exporting a video as a downloadable file. Exporting takes a while, so this only starts it: the result tells you how far along it is and when to check again. Use `get_video_export` with the returned `exportId` until the status is "ready", then give the user the `downloadUrl`. To get a video's transcript use `get_video_transcript` instead. ## CRITICAL CONTEXT RULES 1. **User Context Only:** This tool can only be used when operating on behalf of a specific user. Organization API keys (which have no specific user) cannot export videos. 2. **Permissions:** You can only export videos you own or have been given collaborator or contributor access to; this is enforced automatically and the call fails otherwise. 3. **Asking again is safe:** If an identical export is already running or was finished recently, you get that export back (`alreadyStarted` is true) instead of starting another one. 4. **Download links are temporary.** Do not store or reuse them; call this tool again for a fresh one. 5. **Failures:** If the export fails, the call reports why. Calling this tool again starts a new attempt.

export_video

# Get Assignment Analytics Returns a single Submit assignment's analytics: how many of the requested submissions have been submitted (completion), how they scored against the assignment's maximum points, and how many times they've been viewed and by how many different people. A measure with no data behind it yet — for example an assignment nobody has submitted to or viewed — comes back as `null` rather than `0` or omitted. ## CONTEXT RULES 1. **User Context only:** This tool requires a User Context. Organization API keys are not supported. 2. **Access control:** You can only see analytics for an assignment you own — this tool checks that itself before fetching analytics. An assignment you can't access is reported the same way as one that doesn't exist. 3. **Assignments, not videos:** This is for Submit assignments (topics in search results). For a regular video, use `get_video_analytics`. 4. **Freshness:** Numbers can lag a fresh submission, score or view by a couple of minutes. 5. **New assignments:** An assignment that exists but hasn't been picked up by analytics yet returns all measures as `null` — this is expected, not an error.

get_assignment_analytics

# Get Video Analytics Returns a single video's engagement analytics: how much of it viewers typically watch, how they scored on its quiz (if it has one), and how many times it's been viewed (total and unique views). A measure with no data behind it yet — for example a video with no quiz, or one nobody has watched — comes back as `null` rather than `0` or omitted. ## CONTEXT RULES 1. **User Context only:** This tool requires a User Context. Organization API keys are not supported. 2. **Access control:** You can only see analytics for a video you own — this tool checks that itself before fetching analytics. A video you can't access is reported the same way as one that doesn't exist. 3. **New videos:** A brand-new video with no analytics activity yet simply returns all fields as `null` — this is expected, not an error.

get_video_analytics

# Get Video Export Checks on an export started with `export_video`. While its status is "processing", wait the suggested `retryAfterSeconds` and call this tool again. Once it is "ready", give the user the `downloadUrl`. ## CRITICAL CONTEXT RULES 1. **User Context Only:** This tool can only be used when operating on behalf of a specific user. Organization API keys (which have no specific user) cannot check exports. 2. **Permissions:** You can only check exports of videos you own or have been given collaborator or contributor access to; this is enforced automatically and the call fails otherwise. 3. **Failures:** If the export failed, the call reports why. Call `export_video` again to start a new attempt. 4. **Download links are temporary.** Do not store or reuse them.

get_video_export

# Get Video Transcript Returns a video's transcript as a WebVTT (VTT) file. Small transcripts come back inline, attached as a file named after the video's title (also in `text`), so you can read, summarize or quote them directly. Larger ones come back as a short-lived download `url` instead; give that link to the user, as you cannot read the file yourself. ## CRITICAL CONTEXT RULES 1. **User Context Only:** This tool can only be used when operating on behalf of a specific user. Organization API keys (which have no specific user) cannot read transcripts. 2. **Permissions:** You can only get transcripts for videos you own or have been given collaborator or contributor access to; this is enforced automatically and the call fails otherwise. 3. **Language:** Omit `language` to get the default transcript. If a language is requested and the video has no transcript in it, the call fails rather than falling back to another language. 4. **Download links expire** a few minutes after they are issued. Do not store or reuse them; call this tool again for a fresh one.

get_video_transcript

# Execute Search Executes an advanced search query across videos, folders, topics (assignments), and submissions. Supports complex filtering, ranges, and sorting. ## CRITICAL CONTEXT & ACL ROUTING RULES 1. **User Context:** When operating on behalf of a user, the system automatically secures the payload using their implicit permissions. OMIT `organizationIds` to perform a full cross-organization search across everything the user can see, or provide it to narrow the scope. - *STRICT PROHIBITION:* You cannot manually pass the `orgContext` administrative block in a User Context; the system autonomously handles user boundaries. 2. **Organization Context:** When operating under an organization API key (no user), search is locked to the context organizations. - You MAY pass the `orgContext` administrative block to explicitly filter resources, but ONLY if you also explicitly provide the `organizationIds` array. 3. **Ownership:** To search for resources specifically owned by the active user (e.g., "find my videos", "my folders", "mine"), map `context.user.id` directly into the `ownerId` filter. This ONLY applies when operating in a User Context. Do not map "my" to `ownerId` when in an Organization Context. 4. **Folder Scoping:** Use `folderId` to scope results to a single folder. Pass `folderScope: 'subtree'` to also include everything nested underneath it (any depth), or omit/pass `'direct'` for just that folder's immediate contents. Pass `folderId: null` to search the storage root only. Topics/submissions are never inside a folder, so this has no effect on them. 5. **Topics & Submissions:** A topic's submissions are only visible to callers permitted by that topic's submitter-privacy setting — this is enforced server-side, so fewer submission results than expected likely means most are privacy-restricted for this caller, not a bug. Submission titles are formatted as "{topic title} - {submitter name}".

execute_search

# List Assignments By Metric Ranks the Submit assignments you own by a single measure — completion rate, average score, total views, or unique viewers — from highest to lowest or lowest to highest. Good for "which of my assignments have the lowest completion" or "which have the most unique viewers". ## CONTEXT RULES 1. **User Context only:** This tool requires a User Context. Organization API keys are not supported. 2. **Scope:** Only assignments you own within `orgId` are eligible to appear — this tool resolves that set itself, you don't need to pass assignment IDs. 3. **No data yet:** Assignments are never left out for lacking data. Never-viewed assignments have `0` views; assignments with nothing to average yet have a `null` completion rate or average score and are listed after those with a value. 4. **Assignments, not videos:** For regular videos, use `list_videos_by_metric`.

list_assignments_by_metric

# List Shareable Groups Lists the groups the user can share videos with (for example classes or teams), across all the organizations they belong to. Use it to find a group's ID before calling `update_video_sharing`. ## CRITICAL CONTEXT RULES 1. **User Context Only:** This tool can only be used when operating on behalf of a specific user. Organization API keys (which have no specific user) have no groups to share with. 2. **Who sees which groups:** Admins see every group in their organization; members see the groups they belong to; restricted users (often students) see their own groups only if the organization allows student-to-student sharing. 3. **Names, not IDs:** When talking to the user, always use the group's name (add the organization name if two groups share a name). The ID is only for tool calls.

list_shareable_groups