Synoptic

Submit a stream request to Synoptic support on behalf of the signed-in user. Describe the source or website, desired content and use case. Returns a confirmed support ticket ID; does not create a stream or guarantee delivery. Each call submits a new request; do not automatically retry an uncertain result.

Join the waitlist for early access to the Synoptic trading terminal (beta) for the signed-in account. Sets terminalAccessRequested, which get_me reports; repeating the call changes nothing. Does not grant access, open a support ticket or place trades. Use request_feature for other product requests.

Search the Synoptic stream catalog by keyword. Matches stream names, labels, descriptions, categories, and IDs; does not search post text or accounts on other services. Returns active public streams without sign-in; a signed-in user also gets private streams they own, follow, subscribe to, or were invited to. Results are ordered by follower count, not relevance. Returns the ID, name, description, and Synoptic page URL of each match. Use get_stream to inspect a result before reading posts or configuring targets.

Search full post text within one accessible stream, newest first. Supports ISO date bounds; custom-target restrictions apply. Continue with nextOffset; this differs from opaque history tokens. Use get_stream_posts to page by date without a text query; the search tool finds streams, not posts.

Set how wide a custom collection’s column appears in the signed-in user’s stream deck in the Synoptic app. Display only: sources, filters and posts are unchanged. Use reorder_collections to change column order and update_collection to change content.

Turn the in-app or email channel on or off for the whole signed-in account, not per device. While a channel is off, none of the account’s notifications are delivered on it. Per-event choices made with update_notification_preferences are kept and apply again once it is back on. Returns the saved settings.

Replace the signed-in user’s selected targets on a Synoptic custom-target stream and return the saved list. Targets, such as accounts, channels, repositories, or keywords in the format get_stream describes, choose which of the stream’s posts the user receives. Posts for removed targets stop appearing in the user’s stream reads, post searches, and WebSocket API delivery, and in open Synoptic app feeds after they reconnect; an empty list leaves none. Removed targets are then also removed from the user’s collection sources limited to specific targets, and such a source left with no targets is deleted. The stream’s owner receives all followers’ targets and may use them to decide what to collect. Requires an active direct subscription; values must match the stream’s target format and fit the subscription’s target allowance. Does not purchase access or confirm that targets are collected.

Set the signed-in user’s public Synoptic username to a saved suggestion or their verified X handle. Generate suggestions first when needed.

List one page of active public streams in the Synoptic catalog without signing in. Returns stored stream metadata, optionally filtered by minimum follower count. Use nextToken to continue browsing, search to find a source or topic, and get_stream to inspect a result. Listing a stream does not follow it or grant access to its posts.

List streams the signed-in account owns, including unpublished DRAFT streams, with optional filters and pagination. Use it to find IDs for create_stream_post, update_stream, publish_stream or delete_stream. Use streams_following for streams you follow, and search or streams_all for the public catalog.

List streams the signed-in account follows, with optional metadata filters and pagination. Use streams_created for streams you own, streams_all or search for the public catalog, and get_following_users for followed authors.

Unfollow a stream for the signed-in account. Does not cancel a paid subscription or restore consumed invitations. Use unfollow_user for authors.

Stop following an author as the signed-in user. Returns success=false when no follow exists or the operation fails. Use unfollow_stream to unfollow a stream.

Replace the name and prompt of an AI filter owned by the signed-in user. Future posts in collections using this filter use the updated prompt. This operation does not evaluate a test prompt. Use create_ai_filter for a new filter and delete_ai_filter to remove one.

Replace a custom collection’s name, source list, filters, and highlights. Read get_collection first and preserve desired settings: omitted filters, highlights and AI filter are cleared, matchingSourcesOnly becomes false, and columnWidth resets to null. In the server-managed Related news collection, sources only tune its existing streams and matchingSourcesOnly stays true. Automatically follows eligible sources, may consume invitations, and rebuilds the stored collection feed. An attached AI filter processes incoming posts and can use the account’s AI allowance.

Replace notification channel preferences for mentions, new followers, subscribed-author posts, and system events. Read current settings first; provide all four event groups. Empty arrays disable an event group. IN_APP and EMAIL also need their account-wide switch on; see set_notification_channel. PUSH has no switch.

Update the signed-in user’s public Synoptic profile: display name, biography, avatar, or background image. Changes are visible to other users. Omitted fields stay unchanged. Media must already be uploaded to Synoptic. Use set_username for the username, or remove_x_handle to unlink X.

Update owned stream metadata. Omitted fields retain current values. A supplied description replaces its formatting with plain text. Does not change visibility, pricing, or custom-target configuration.

Rename an existing stream deck owned by the signed-in user; nothing else changes. Use reorder_stream_decks to move it or delete_stream_deck to remove it.

Rename a terminal tab or replace its entire saved layout configuration. Omitted fields retain their previous values. Read list_terminal_tabs before replacing a layout. Does not place trades.