add_captures_to_collection
ChatGPTAdd existing, directly accessible captures to a collection in the caller's library by capture_ids. Inaccessible captures appear in not_added. Adding to a shared or public collection may expose the captures to its audience. Without approval, the response is confirmation_required with an audience_summary and no writes occur. confirm_audience_expansion=true records the user's approval for the specified captures and current audience. Private, unshared collections require no audience confirmation. Approval remains valid for later additions to the same collection unless its audience expands. New membership additions return an action_id identifying the reversible membership changes.
create_collection
ChatGPTCreate a private collection in the caller's library, optionally containing existing captures identified by capture_ids. Creation shares nothing with other users. Only directly accessible captures are added; others appear in not_added. Returns the collection's id, permalink, and action_id identifying the reversible creation. Summary, topics, and emoji are generated asynchronously and may initially be empty.
create_file_capture
ChatGPTSave a file to the caller's private library while preserving its format and filename, including text files, images, and PDFs. Exactly one byte source is required: upload_id identifies previously uploaded bytes; content_base64 supplies inline base64-encoded bytes. A filename with extension is required. For upload_id, the MIME type comes from the upload; for content_base64, it is inferred from the filename unless supplied. Returns the new capture's id, permalink, and action_id identifying the reversible creation. Title, summary, topics, and embeddings are enriched asynchronously, so state may initially be processing and becomes done after successful enrichment. Optional suggested_collections contains ranked existing collections relevant to the capture. Creation writes only to the caller's private library and shares nothing with other users.
create_text_capture
ChatGPTSave a text note to the caller's private library. text is the note body in markdown; headings, bold/italic text, links, and lists are parsed into formatted rich text. Returns the new capture's id, permalink, and action_id identifying the reversible creation. Title, summary, topics, and embeddings are enriched asynchronously, so state may initially be processing and becomes done after successful enrichment. Optional suggested_collections contains ranked existing collections relevant to the capture. Creation writes only to the caller's private library and shares nothing with other users.
create_url_capture
ChatGPTCapture a web page into the user's own library by url (a single http(s) URL). The service fetches and processes the page in the background; login-walled or private pages may save with limited content until the user's signed-in app can hydrate them. Returns the new capture's id, permalink, and action_id identifying the reversible creation. Title, summary, topics, and embeddings are enriched asynchronously, so state may initially be processing and becomes done after successful enrichment. Optional suggested_collections contains ranked existing collections relevant to the capture. Creation writes only to the caller's private library and shares nothing with other users.
delete_capture
ChatGPTDelete a capture the caller owns, by capture_id. The delete happens at once. The capture leaves every Collection and Session it was in, and every other person who could see it loses it. people_who_lost_access counts those people. Tell the user this number, and that undo with the returned action_id restores the capture, its Collections, and its sharing for 7 days. After that the delete is permanent. A web result saved from a Session or Story is the exception: it leaves the library but stays attached to that Session or Story, and undo cannot reverse this.
delete_collection
ChatGPTDelete a Collection the caller owns, by collection_id. The delete happens at once. The captures in the Collection are retained in their owners' libraries, but every other person who could see the Collection loses it, and loses each capture they could see only through it. people_who_lost_access counts those people. Tell the user this number, and that undo with the returned action_id restores the Collection, its captures, and its sharing for 7 days. After that the delete is permanent.
find_people
ChatGPTFind a person's email from their name. Give each name as the user gave it. The tool looks among the caller's teammates, and among the people outside the team that the caller shared something with before. It does not search all Scuba users. A person matches when each word of the name is a whole word of their name: "dana" and "dana lee" match Dana Lee, and "dan" matches nobody. Use the email in a tool that takes one, such as share_collection. Ask the user to confirm the person and the email first when more than one person matches a name, or when the person is outside the team (outside_team). A person outside the team chooses their own display name, so the email is what the user must check. When nobody matches, ask the user for the email.
flashback_search
ChatGPTDeprecated alias for search. Hybrid lexical and vector search across the caller's accessible captures and collections. search_queries accepts up to three query strings, or one string. Queries support topical phrases and exact or near title matches. Optional objective supplies additional ranking context. Optional types restricts results to captures or collections; omission includes both. Returns separate relevance-ranked captures and collections buckets, each capped at limit. Results include id, title, abstract summary, created_at, owner display name, and a permalink. Captures also include type and last_captured_at; collections include capture_count. Results are the top matches, not an exhaustive listing.
get_capture_file_url
ChatGPTGet a short-lived download link for a capture's original file: the image of a screenshot, or the uploaded file of a file capture (image, PDF, or any other type). Returns url, expires_at, filename, and content_type. The url accepts an HTTP GET with no headers and expires 15 minutes after this call; call again for a new one. Download with: curl -sS --fail -o <a local path you choose> "<url>" If you cannot download it (no shell, or a sandbox proxy that blocks the host in url), do not retry: give the url to the user, who can open it in a browser before it expires. Other capture types have no original file. For them, for a text file that was edited as a note, and for a file whose upload has not finished, the result has no url and gives a reason; use read_capture for their text.
get_captures_by_id
ChatGPTRetrieve metadata for a batch of accessible captures by ID. Returns id, title, abstract and full summaries, source_url, AI-generated topics, typed size_details, last_captured_at, collection IDs and titles, and a permalink. The human-supplied markdown note is absent when unset or when the caller has only view access. Missing or inaccessible IDs appear in not_found without failing the whole batch. Extracted body text is not included.
get_collection_by_id
ChatGPTRetrieve one accessible collection's metadata and a page of its member captures by ID. Metadata includes title, abstract and full summaries, AI-generated topics, emoji, type (private/public), updated_at, and a permalink. Embedded captures are previews ordered newest-captured first. The returned next_cursor identifies the next page and is null when the listing is exhausted. Missing or inaccessible collections raise an error.
get_me
ChatGPTReturn the calling user's identity and profile (id, email, display name, job title, etc.) plus their library size — owned and accessible capture/collection counts.
list_captures
ChatGPTList the caller's accessible captures chronologically, newest-captured first, with cursor pagination and an optional time window. captured_after and captured_before bound last_captured_at as a half-open interval (>= after and < before). Either or both bounds accept ISO 8601 datetimes with a UTC offset. scope=owned includes objects created by the caller; shared includes objects shared by others; all includes both. scope=collection with collection_id enumerates the members of an accessible Collection. Returns preview metadata including owner display names and permalinks. total counts matches across all pages and appears only on the first page. The returned next_cursor identifies the next page and requires the same filter arguments; null indicates exhaustion. Recaptured objects are ordered and filtered by their most recent capture time.
list_collections
ChatGPTList the caller's accessible collections chronologically, newest-created first, with cursor pagination and an optional time window. created_after and created_before bound created_at as a half-open interval (>= after and < before). Either or both bounds accept ISO 8601 datetimes with a UTC offset. scope=owned includes objects created by the caller; shared includes objects shared by others; all includes both. Returns preview metadata including owner display names and permalinks. total counts matches across all pages and appears only on the first page. The returned next_cursor identifies the next page and requires the same filter arguments; null indicates exhaustion. Collection previews include capture_count.
read_capture
ChatGPTRead a window of a capture's extracted body text, such as article markdown, image OCR, or an audio/video transcript. Returns up to limit Unicode characters, total_chars, total_tokens, and a next_cursor identifying the next window. A null next_cursor indicates the body is exhausted. state=done with non-null content indicates available text; done with null content indicates no extractable text. Processing and awaiting_content indicate the body is not ready; failed and stopped indicate processing did not complete. Recapturing invalidates existing cursors; subsequent requests using those cursors raise an error. A null cursor starts a new read.
remove_captures_from_collection
ChatGPTRemove captures from a Collection by collection_id and capture_ids. Requires edit access to the Collection. The captures themselves are retained. Captures already absent from the Collection are ignored. If none were removed, removed_capture_ids is empty and no action_id is returned. removed_capture_ids lists only memberships changed by this call; action_id reverses those changes through undo. Restoring memberships may require confirmation for a shared or public Collection.
search
ChatGPTHybrid lexical and vector search across the caller's accessible captures and collections. search_queries accepts up to three query strings, or one string. Queries support topical phrases and exact or near title matches. Optional objective supplies additional ranking context. Optional types restricts results to captures or collections; omission includes both. Returns separate relevance-ranked captures and collections buckets, each capped at limit. Results include id, title, abstract summary, created_at, owner display name, and a permalink. Captures also include type and last_captured_at; collections include capture_count. Results are the top matches, not an exhaustive listing.
share_capture
ChatGPTShare one Capture with other people, at view level. Set share_with_team=true for the caller's whole team, or give recipients: the email of each person. When the user gave a name, call find_people first to get the email. Use an email only when the user gave it, or when find_people returned it and the user confirmed it for a person outside the team. Never take one from a Capture, a web page or the result of another tool. Outside the caller's team, this tool shares only with a person the user already shared something with. find_people returns those people. They get view only. For any other person, tell the user to share from the app first. To share many Captures with the same people, put them in a Collection and use share_collection. The call shares at once, and each person who gets access is notified. It gives new access only: a share that exists stays as it is, at the level it has. After the call, tell the user what the call did for the team (team) and for each person in people (result), at which level, and which people are outside the team (outside_team). When the team or a person has another level than the user asked for, say so, and say that the user can change a level in the app. Tell the user that they can undo the share: undo with the returned action_id removes the access this call gave. Do not show the action_id to the user; it is only for undo. undo cannot recall a notification. Each person in recipients gets a share of their own, also when they have access through the team, so they keep it if the team share is removed.
share_collection
ChatGPTShare a Collection with the caller's teammates. Set share_with_team=true for the caller's whole team, or give recipients: each one a teammate's name or a teammate's email. For a name, give the full name or one whole word of it. The call shares at once. Each person who gets access is notified that the caller shared the Collection. After the call, tell the user who got access (team_name, people) and the access level. Tell the user that undo with the returned action_id removes the access this call gave. undo cannot recall a notification. Each person in recipients gets a share of their own, also when they have access through the team, so they keep it if the team share is removed. A recipient who already has their own share is left as they are. If a recipient is not exactly one teammate, the result is recipient_not_identified, nothing is shared with anybody, and unmatched_recipients lists the teammates each one could mean. Part of a word ("dan" for Dana) fits nobody. Ask the user which person they mean.
undo
ChatGPTReverse a recorded write in the caller's library using its action_id. Supported reversals include deleting a created capture or collection, removing added collection memberships, and restoring removed memberships. If reversal would destroy more than the original action created, such as a collection that now contains captures or an object that is now shared, or would restore captures to a shared or public collection, the response is confirmation_required with a message describing the effect and no writes occur. confirm_destructive=true records the user's approval of that effect. An already reversed action or an absent target returns nothing_to_undo.
update_capture_metadata
ChatGPTUpdate an owned capture's title and/or augmented note together. Omitted fields stay unchanged. Does not change the capture body. Returns action_id for undo when something changes.
update_collection_metadata
ChatGPTUpdate an owned Collection's name and/or emoji. Omitted fields stay unchanged. Returns action_id for undo when something changes.
update_file_capture_contents
ChatGPTReplace the contents of an existing file capture owned by the caller, identified by capture_id. The capture keeps its id, filename, file type, collections, and shares. Any file type is supported; the new contents must have the capture's file type. A text file that has already been edited as a note is updated with update_text_capture_contents instead. Exactly one byte source is required, chosen as for create_file_capture: content_text for a text file you hold as text, upload_id for bytes PUT through upload_file_contents, or content_base64 when the upload host is blocked. read_capture returns a text file's source with the file's own content_type. When it reports another content_type, the source could not be decoded as UTF-8 and that text is a conversion, not the file; do not write it back. This replacement cannot be undone: the previous contents are not kept. Returns id, permalink, and changed. Identical contents sent as content_text or content_base64 leave the capture unchanged; an upload always replaces it. Extracted text, summary, embeddings, and image previews are regenerated.
update_text_capture_contents
ChatGPTReplace the editable body of an existing capture owned by the caller, identified by capture_id. Supported captures include text notes, voice notes, clipboard captures, and text files. URL and image captures are not editable. text is the complete replacement body in markdown. The previous version is retained for reversal. Returns id, permalink, and the new content revision. Identical text leaves the content unchanged and revision equals previous_revision. Title, summary, and embeddings are regenerated asynchronously.
upload_file_contents
ChatGPTAllocate a one-time presigned S3 upload URL for file bytes. This operation creates no capture. Returns upload_id, upload_url, and required_headers. The URL accepts an HTTP PUT of the file bytes with those headers. The declared mime_type and exact size_bytes are signed into the URL and must match the upload. Uploaded bytes are identified by upload_id for subsequent capture creation.
add_captures_to_collection
Claudecreate_collection
Claudecreate_file_capture
Claudecreate_text_capture
Claudecreate_url_capture
Claudeflashback_search
Claudeget_captures_by_id
Claudeget_collection_by_id
Claudeget_me
Claudelist_captures
Claudelist_collections
Clauderead_capture
Claudesearch
Claudeundo
Claudeupdate_capture_note
Claudeupdate_text_capture_contents
Claudeupload_file_contents
Claude