> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zas.red/llms.txt
> Use this file to discover all available pages before exploring further.

# Fix a Zas AI connection

> Recover from missing channels, failed uploads, expired connections, and the wrong integration.

> [accordion] The assistant asks me to install Slack
>
> Select the installed Zas connection explicitly: **@Zas** in ChatGPT, or **+ → Connectors → Zas** in Claude. Ask it to list approved Zas channels before sending. Slack does not provide access to Zas. If Zas is missing, follow the relevant setup guide.

> [accordion] My channel is missing
>
> Check the signed-in Zas account and whether you selected that channel during approval. Joined channels also need the owner's permission. Organization channels need both admin approvals, an active plan, agents enabled, and current membership. The current picker supports accounts with up to 100 channels and at most 20 selected channels per connection; existing plan and agent limits still apply.

> [accordion] I can send notes but cannot read or send a file
>
> Check **Read** and **Send** separately. Notes need Send; reading needs Read; original-file sends currently need both. Reconnect with the intended grants if needed. The assistant cannot grant itself more access.

> [accordion] Claude reports that the upload domain is blocked
>
> Where your plan and workspace permit, allow **zas.red** under Claude **Settings → Capabilities**. A connector's OAuth approval does not grant its code sandbox network access. If your organization blocks it, ask its administrator; do not bypass that restriction.

> [accordion] ChatGPT reports a file safety-status failure
>
> This is an AI-host file-access failure. The original may not be available to Zas even though notes work. No completed receipt means no confirmed send. Keep the file, retry through the host's supported attachment flow when available, or upload it directly in Zas. Do not disable safety checks or treat a summary as the original file.

> [accordion] The connection expired or needs attention
>
> Open [AI connections](https://zas.red/ai/connect). Check its status and expiry. Finish any pending disconnect, then reconnect from your AI app and approve the channels again. Authorization lasts at most 30 days; automatic renewal does not extend it forever.

> [accordion] A document uploads but the AI cannot read it
>
> File delivery does not guarantee text extraction. Notes and inline UTF-8 text have a 64 KiB limit; original file reads and DOCX inputs have a 4 MiB limit. DOCX extracts body text, not embedded images, and applies additional extraction safety limits. For a PDF, ask the assistant to read its pages: up to 10 pages per request from a PDF up to 20 MiB. Other formats need a compatible reader in your AI app.

> [accordion] The assistant says an item is too large to read
>
> For a text file over 64 KiB (65,536 UTF-8 bytes) and up to 4 MiB (4,194,304 original bytes), ask the assistant to call `zas_get_file` with the same channel and item, then decode its base64 resource as UTF-8. A 3,900,000-byte text file fits this path. The limit counts bytes before base64 encoding. For a larger file up to 50 MiB, request `zas_read_link`. Notes cannot use file tools. If no connector path applies, use the item’s `open` link while signed in to a Zas account with access to the channel.

> [accordion] The download link answers 404
>
> A link lasts 10 minutes and allows 3 downloads, and it stops working when you disconnect the app. Ask the assistant for a new link.

> [accordion] The assistant cannot hear an audio file
>
> If the host cannot listen inline, request a download link. The host needs permission to download and process the file; a link alone does not guarantee a transcript. Open the item in Zas to play it yourself.

> [accordion] The assistant says it sent something, but I cannot find it
>
> Ask for the saved item ID and exact destination. An upload permit or progress message is not a final receipt. Open that channel in Zas, check expiration, and avoid repeated new sends while the first result is uncertain. The connector supports retrying the same operation without creating another item.

> [accordion] The assistant reports an internal error or timeout
>
> Retry the same read or listing once. A failed listing is not an empty channel, and an internal error is not evidence of a size limit, a covered item or missing permission. Do not repeat a permanent refusal such as `too_large` or `grant_denied` unchanged. If the retry fails, keep the visible request ID and time for support. For an uncertain send, keep the same operation instead of creating a new send.

> [accordion] A tool is missing or its description is outdated
>
> **Checked 17 November 2026:** the published ChatGPT plugin still shows **Read 6 + Write 5 = 11 tools**. The current Zas hosted catalog has **Read 10 + Write 5 = 15**. The four additional readers are `zas_read_image`, `zas_read_pages`, `zas_read_audio` and `zas_read_link`. The published catalog also has older file-read descriptions and listing inputs.
>
> Zas has escalated the blocked catalog refresh to OpenAI Support. Publishing version 0.2.0 did not refresh those tool definitions. You do not need to reconnect or grant more channel access for this update. While it is pending, use the available tools or an item’s `open` link in signed-in Zas.
>
> For a custom connection, use **Refresh tools** if the host offers that control, then start a new conversation and select that connection. This is separate from the published ChatGPT plugin’s catalog. Claude has its own tool snapshot. A 512 KiB file-read description is outdated; the original-byte read limit remains 4 MiB. Do not confuse it with the separate 512 KiB inline file-send limit.

## Contact support

Email [support@zas.red](mailto:support@zas.red) with the AI app, browser, approximate time and timezone, tool name, visible error and **request ID** if shown. Each retry has a new ID; include both if available. If useful, include a saved item ID. Do not send passwords, tokens, secret share links, private file contents, or unredacted OAuth URLs.

[ChatGPT setup](https://docs.zas.red/en/ai/chatgpt.md) · [Claude setup](https://docs.zas.red/en/ai/claude.md) · [Connection management](https://zas.red/ai/connect)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.