Built-in tool
Read a file
Find and read chat files, and watch videos: sampled frames with the spoken audio transcribed.
Endpoint
Parameters
| Name | Type | Required | Note |
|---|---|---|---|
| pagenumber · optional | number | optional | PDF page to inspect visually, numbered from 1. Omit for page 1; read additional pages separately. |
| pathstring · optional | string | optional | For a ZIP attachment: the file inside it to read, by the path in its file list (e.g. SKILL.md or references/guide.md). Omit to read the ZIP's file list and text overview. Example: |
| limitnumber · optional | number | optional | Read: maximum characters, default 20000. List/search: maximum files, default 20, capped at 50. Default: |
| querystring · optional | string | optional | Required for search: words to find in file names and descriptions. |
| offsetnumber · optional | number | optional | Read: character offset. List/search: file offset. Follow nextOffset to continue. |
| canvasIdstring · optional | string | optional | Instead of attachmentId, inspect a video uploaded into this accessible Page. Get the exact canvasId from canvas-list or canvas-get. |
| operationstring · optional | string | optional | Default read. List available uploaded Context files, or search their names/descriptions, then read an attachmentId. One of: |
| videoIndexnumber · optional | number | optional | Page video to inspect, numbered from 0; defaults to its first uploaded video. Use only with canvasId. |
| attachmentIdstring · optional | string | optional | For an attachment read: stable Attachment ID from Context. For a video uploaded into a Page use canvasId instead. No download URL is needed. |
| startSecondsnumber · optional | number | optional | Video only: start a bounded 60-second inspection window. Follow nextStartSeconds to inspect the rest. |
| conversationIdstring · optional | string | optional | For list/search outside a chat: the source conversation you can read. In chat, defaults to the current conversation. |