# Clatter Labs Help Center > Answers to common questions about every Clatter Labs product: accounts, plans and billing, SuperCosmos models, the APIs, Line CLI, Code Buckets and more. Developer reference: https://developers.clatterlabs.com. Contact: support@clatterlabs.com or team@clatterlabs.xyz. ## Clatter Labs Account Your Cloud ID, signing in, two-factor authentication, profile, data export and deleting your account. ### Getting started - [Can I have more than one Clatter Labs account?](https://help.clatterlabs.com/account/getting-started/one-account-or-many): You can't create extra accounts to get around limits, free credit, invites or suspensions. One person should use one personal account. - [Can I share my account with a friend or coworker?](https://help.clatterlabs.com/account/getting-started/account-is-personal): No. A Clatter Labs account is personal and can't be shared, sold, rented or transferred. Use a team so each person has their own account. - [Do I have to keep my account details up to date?](https://help.clatterlabs.com/account/getting-started/keep-my-info-up-to-date): Yes. The Terms ask you to keep registration details accurate, and your email must work so you can receive codes and alerts. - [How do I create a Clatter Labs account?](https://help.clatterlabs.com/account/getting-started/create-an-account): Sign up at accounts.clatterlabs.com with your email, or continue with GitHub, Vercel or Hugging Face. It takes a minute. - [How old do I have to be to get a Clatter Labs account?](https://help.clatterlabs.com/account/getting-started/how-old-do-i-have-to-be): You must be at least 13. Teens may need a parent or guardian's consent, and in Egypt anyone under 18 needs it. - [I'm new to this. Why do I need an account at all?](https://help.clatterlabs.com/account/getting-started/explain-account-simply): It's like a key that opens all Clatter Labs apps. You make it once with your email and use it everywhere. - [Is a Clatter Labs account free?](https://help.clatterlabs.com/account/getting-started/is-a-clatter-labs-account-free): Yes. Creating an account costs nothing, every account starts on the Free plan, and new accounts get $5 of free API credit once. - [Is Clatter Labs available in my language?](https://help.clatterlabs.com/account/getting-started/which-language): Clatter Labs services are offered in English. Translations of legal pages are for convenience only; the English version controls. - [What can I do with my Clatter Labs account?](https://help.clatterlabs.com/account/getting-started/what-can-i-use-my-account-for): Your account lets you use Line CLI, Cosmos Agent, Code Buckets, the Console and the APIs, all on one plan and one credit balance. - [What is a Clatter Labs account?](https://help.clatterlabs.com/account/getting-started/what-is-a-clatter-labs-account): One Clatter Labs account signs you in to every Clatter Labs app and tool, from the Console to Line CLI and Code Buckets. ### Signing in - [How do I log in? (simple steps)](https://help.clatterlabs.com/account/sign-in/sign-in-kids): Go to accounts.clatterlabs.com, type your email, then type the 6-digit code we send you. That's it. - [How do I sign in to my Clatter Labs account?](https://help.clatterlabs.com/account/sign-in/how-to-sign-in): Go to accounts.clatterlabs.com and sign in with an email code, your password, or GitHub, Vercel or Hugging Face. - [How do I sign in with a code sent to my email?](https://help.clatterlabs.com/account/sign-in/sign-in-with-email-code): Choose Log in with your email, enter your address, then type the 6-digit code from the email. Use Resend code if it doesn't arrive. - [How do I sign in with GitHub, Vercel or Hugging Face?](https://help.clatterlabs.com/account/sign-in/sign-in-with-github-vercel-hugging-face): Choose the provider on the sign-in page and approve the request. We only receive the profile details that provider shares with your permission. - [How do I sign in with my email and password?](https://help.clatterlabs.com/account/sign-in/sign-in-with-password): Choose Login with password, enter your email and password, and add your two-factor code if it's turned on. - [How long do I stay signed in?](https://help.clatterlabs.com/account/sign-in/stay-signed-in): Sessions last up to 15 days for security. After that, you'll be asked to sign in again. - [I signed up with GitHub. Can I sign in another way?](https://help.clatterlabs.com/account/sign-in/can-i-use-a-different-sign-in-method): Usually yes: you can sign in with a code sent to the same email address. Your account is tied to your email. - [What does "Sign in with Clatter Labs" mean on other apps?](https://help.clatterlabs.com/account/sign-in/what-is-sign-in-with-clatter-labs): Some apps let you sign in with your Clatter Labs account. You choose what they can see, and you can revoke them later. - [What does GitHub, Vercel or Hugging Face share with Clatter Labs when I sign in?](https://help.clatterlabs.com/account/sign-in/what-does-github-share-with-clatter): Only your identifier, email, name and avatar as the provider releases them with your permission. Never your password. - [Why did I get an email about a new sign-in?](https://help.clatterlabs.com/account/sign-in/sign-in-new-device-email): We email you when your account is used on a new device, with details to help you spot sign-ins that weren't you. - [Why does sign-in show a security check?](https://help.clatterlabs.com/account/sign-in/sign-in-security-check): Sign-up, sign-in and password reset forms use an automated check to keep bots out. It usually runs by itself. ### Passwords - [Can Clatter Labs support tell me my password?](https://help.clatterlabs.com/account/passwords/can-support-tell-me-my-password): No. Passwords are stored only as salted hashes, so nobody can read them. Reset it yourself instead. - [Do I need a password for my Clatter Labs account?](https://help.clatterlabs.com/account/passwords/do-i-need-a-password): No. You can sign in with an email code or GitHub, Vercel or Hugging Face. A password is optional. - [How do I set or change my password?](https://help.clatterlabs.com/account/passwords/set-or-change-password): Open Security in the account center and choose to manage your password. You may be asked to confirm it's you first. - [I didn't get a password reset email](https://help.clatterlabs.com/account/passwords/no-reset-email): Check spam, make sure you used your account's email, and wait a minute before requesting again. Email codes are another way in. - [I forgot my password. How do I reset it?](https://help.clatterlabs.com/account/passwords/forgot-my-password): Choose Forgot your password?, enter your email, and use the secure reset link we send. You can also sign in with an email code. - [I think someone knows my password. What should I do?](https://help.clatterlabs.com/account/passwords/someone-knows-my-password): Change your password now, sign out other devices, turn on two-factor authentication and check your API keys. - [My password reset link says it's invalid or expired](https://help.clatterlabs.com/account/passwords/reset-link-expired): Reset links work once and expire. Request a new link from the sign-in page and use the newest email. - [What are the password requirements?](https://help.clatterlabs.com/account/passwords/password-requirements): Passwords must be at least 8 characters. Longer, unique passwords are safer. ### Two-factor authentication - [Does two-factor authentication protect my API keys?](https://help.clatterlabs.com/account/two-factor/does-two-factor-protect-api-keys): 2FA protects sign-in to your account. API keys work on their own, so keep them secret and revoke any that leak. - [How do I turn off two-factor authentication?](https://help.clatterlabs.com/account/two-factor/turn-off-two-factor): In Security, choose Disable two-factor authentication and enter your current 6-digit code to confirm. - [How do I turn on two-factor authentication?](https://help.clatterlabs.com/account/two-factor/turn-on-two-factor): In Security, choose Add an authenticator app, scan the QR code, and enter the 6-digit code to confirm. - [I can't scan the QR code for two-factor authentication](https://help.clatterlabs.com/account/two-factor/cant-scan-qr-code): Choose Can't scan? Show setup key, and type the key into your authenticator app by hand. - [I got a new phone. How do I move my two-factor codes?](https://help.clatterlabs.com/account/two-factor/i-got-a-new-phone): While you still have the old phone, turn 2FA off and on again to scan a new QR code with the new phone. - [I lost my phone or authenticator app and can't sign in](https://help.clatterlabs.com/account/two-factor/lost-my-authenticator): Without your authenticator code you can't pass two-factor sign-in. Contact support from your account email so we can verify you and help. - [My two-factor code isn't accepted](https://help.clatterlabs.com/account/two-factor/code-not-accepted): Most often the phone's clock is off. Set the time to automatic, use the newest code, and check you picked the Clatter Labs entry. - [Should I turn on two-factor authentication?](https://help.clatterlabs.com/account/two-factor/should-i-turn-on-two-factor): Yes. It's the simplest way to stop someone with your password or email from taking over your account. - [What is two-factor authentication?](https://help.clatterlabs.com/account/two-factor/what-is-two-factor-authentication): Two-factor authentication adds a second step to sign-in: a 6-digit code from an authenticator app on your phone. - [What's that 6-number code app my account asks for?](https://help.clatterlabs.com/account/two-factor/two-factor-for-kids): It's an authenticator app. It makes a new secret code every few seconds so only you can get into your account. - [When will I be asked for my two-factor code?](https://help.clatterlabs.com/account/two-factor/when-is-two-factor-asked): Once 2FA is on, the code is required on every sign-in and for sensitive actions like downloading your data or deleting your account. - [Which authenticator apps work with Clatter Labs?](https://help.clatterlabs.com/account/two-factor/which-authenticator-apps-work): Any app that makes standard 6-digit time-based codes (TOTP) works, including Google Authenticator and Microsoft Authenticator. ### Profile and preferences - [Can Clatter Labs make me change my name or username?](https://help.clatterlabs.com/account/profile/change-username): Yes, in rare cases: names that infringe others' rights, impersonate someone or are misleading may need to change. - [Can I remove my profile picture?](https://help.clatterlabs.com/account/profile/remove-profile-picture): Yes. A picture is optional. Open Name & picture and replace or remove it. - [How do I change my name or profile picture?](https://help.clatterlabs.com/account/profile/change-name-and-picture): Open your profile in the account center, choose Change profile, and update your name or upload a new picture. - [How do I change the email address on my account?](https://help.clatterlabs.com/account/profile/change-email-address): If you don't see an option to change your email, contact support from your current address. Your Account ID doesn't change. - [How do I switch between dark and light mode?](https://help.clatterlabs.com/account/profile/change-theme): In the account center, choose dark, light, or match your system. The choice is saved on that device. - [My profile picture won't upload](https://help.clatterlabs.com/account/profile/picture-upload-failed): Check the file is PNG, JPEG, WebP, GIF or AVIF and under 25MB, then try again on a stable connection. - [What image can I use as my profile picture?](https://help.clatterlabs.com/account/profile/picture-requirements): Use a PNG, JPEG, WebP, GIF or AVIF image up to 25MB. - [Where is my name and picture shown?](https://help.clatterlabs.com/account/profile/where-is-my-name-shown): Your name and picture appear across Clatter Labs apps, and to apps you sign in to if you allow them to see your profile. ### Sessions and devices - [How do I see where I'm signed in?](https://help.clatterlabs.com/account/sessions-devices/see-where-im-signed-in): Open Devices or Sessions in the account center to see devices signed in, their last activity, IP address and operating system. - [How do I sign out a device I'm not using?](https://help.clatterlabs.com/account/sessions-devices/sign-out-a-device): Find the device in Devices or Sessions and revoke it. It's signed out right away. - [How do I sign out of all my devices?](https://help.clatterlabs.com/account/sessions-devices/sign-out-everywhere): Revoke each session you don't need in Sessions, and change your password if you think someone else has access. - [I see a device I don't recognize](https://help.clatterlabs.com/account/sessions-devices/unknown-device): Revoke it, change your password and turn on two-factor authentication. Locations come from IP addresses and can be approximate. - [I signed in on a public or shared computer. What should I do?](https://help.clatterlabs.com/account/sessions-devices/public-computer): Sign out when you're done, and if you forgot, revoke that session from your own device. - [Is it safe to stay signed in on a family computer?](https://help.clatterlabs.com/account/sessions-devices/stay-signed-in-on-shared-device): It's convenient but anyone using that computer can act as you. Use separate browser profiles or sign out after use. - [What are the notifications in my account center?](https://help.clatterlabs.com/account/sessions-devices/notifications-page): The account center keeps in-app notifications, like security notices, even if an email couldn't be sent. - [What does the Activity page show?](https://help.clatterlabs.com/account/sessions-devices/activity-page): The Activity page lists recent activity on your account so you can spot anything unexpected. - [Why was I signed out unexpectedly?](https://help.clatterlabs.com/account/sessions-devices/signed-out-unexpectedly): Sessions end after 15 days, when revoked from another device, or when browser data is cleared. Sign in again. ### Connected apps - [An app says "This application is not registered or has been disabled"](https://help.clatterlabs.com/account/connected-apps/app-not-registered): The app's Sign in with Clatter Labs is switched off or isn't approved. Contact the app's developer. - [Can I add Sign in with Clatter Labs to my own app?](https://help.clatterlabs.com/account/connected-apps/build-app-with-clatter-sign-in): Clatter Cloud sign-in is available for approved third-party apps. The public docs don't cover it, so contact us first. - [How do I revoke an app's access to my account?](https://help.clatterlabs.com/account/connected-apps/revoke-app-access): Open Connected apps, pick the app and revoke it. It's signed out immediately and can't get new data from your account. - [I revoked an app. Does it delete the data it already got?](https://help.clatterlabs.com/account/connected-apps/revoked-app-still-has-my-data): Revoking stops new access. Data the app already received is governed by that app's own privacy policy. - [I see a connected app I don't remember](https://help.clatterlabs.com/account/connected-apps/unknown-connected-app): If you don't recognise an app, revoke it, then check your sessions and change your password if needed. - [What are connected apps?](https://help.clatterlabs.com/account/connected-apps/what-are-connected-apps): Connected apps are apps you signed in to with your Clatter Labs account. You can review and revoke them any time. - [What can an app see when I sign in with Clatter Labs?](https://help.clatterlabs.com/account/connected-apps/what-an-app-can-see): Only what the consent screen lists, such as your Cloud ID, email, name and picture, and only if you continue. - [What does "Offline access" mean on the consent screen?](https://help.clatterlabs.com/account/connected-apps/offline-access): Offline access lets an app stay connected when you're not actively using it, until you revoke it. ### Early access and waitlists - [How are early-access requests decided?](https://help.clatterlabs.com/account/early-access/how-early-access-is-decided): An AI review system may score requests to set the order. You can ask for a human to review the decision. - [How do I join a waitlist?](https://help.clatterlabs.com/account/early-access/join-a-waitlist): Sign in, open the app's early-access screen and choose Join the waitlist. You'll be told when you're in. - [How do I use an early-access invite code?](https://help.clatterlabs.com/account/early-access/redeem-invite-code): Choose Have an invite code? on the early-access screen and enter it. Codes are single use and expire in 24 hours. - [My invite code isn't working](https://help.clatterlabs.com/account/early-access/invite-code-not-working): Invite codes work once and expire after 24 hours. Ask the person who invited you for a new one. - [Why does an app show me an early-access screen?](https://help.clatterlabs.com/account/early-access/what-is-a-waitlist): Some Clatter Labs apps are in early access. You can join the waitlist or redeem an invite code to get in. ### Download your data - [Does my data export include my Code Buckets files?](https://help.clatterlabs.com/account/data-export/export-code-buckets-files): Download your stored files from Code Buckets itself using the Console or the API. The account export is for account data. - [How do I download my data?](https://help.clatterlabs.com/account/data-export/download-your-data): Open Data in the account center, choose Download your data, confirm it's you, and save the .zip file. It downloads once. - [It says to sign out and back in before I can download my data](https://help.clatterlabs.com/account/data-export/export-needs-recent-sign-in): Exports need a recent sign-in. Sign out, sign back in, and return to Data within 10 minutes. - [My data download link doesn't work any more](https://help.clatterlabs.com/account/data-export/export-link-already-used): Each export downloads once. Start a new export from Download your data. - [Should I download my data before deleting my account?](https://help.clatterlabs.com/account/data-export/export-before-deleting): Yes. Immediate deletion is permanent, so download your data and your Code Buckets files first. - [What's in my data export?](https://help.clatterlabs.com/account/data-export/whats-in-my-data-export): A .zip with a JSON file for each Clatter Labs service. Passwords, secrets and tokens are left out for security. - [Why aren't my API keys or tokens in my export?](https://help.clatterlabs.com/account/data-export/why-no-passwords-in-export): Passwords, secrets and tokens are excluded so a stolen export can't be used to break into your account or services. ### Closing or deleting your account - [Can I create a new account after deleting my old one?](https://help.clatterlabs.com/account/delete-account/create-new-account-after-deleting): Usually yes, with a new Account ID and no old data, unless the old account was terminated for breaking the Terms. - [Can I delete my data from just one Clatter Labs service?](https://help.clatterlabs.com/account/delete-account/delete-one-service-only): Yes. Email infrastructure@clatterlabs.xyz from your account email and say which service's data to delete permanently. - [How do I cancel a scheduled account deletion?](https://help.clatterlabs.com/account/delete-account/cancel-scheduled-deletion): Sign in before the deadline, open Data, and choose Cancel deletion. Your account is restored. - [How do I close my account? (for younger users)](https://help.clatterlabs.com/account/delete-account/delete-account-for-kids): Ask a parent or guardian to help. Go to Data, choose Delete account, and pick 30 days if you might want it back. - [How do I delete my Clatter Labs account?](https://help.clatterlabs.com/account/delete-account/how-to-delete-my-account): Open Data, choose Delete account, then pick Delete immediately or Schedule for 30 days. You'll need to confirm it's you. - [I can't sign in. How do I delete my account?](https://help.clatterlabs.com/account/delete-account/delete-account-without-access): Recover access first, or email infrastructure@clatterlabs.xyz from your account email to request permanent deletion. - [I deleted my account by mistake](https://help.clatterlabs.com/account/delete-account/deleted-by-mistake): If you scheduled deletion, cancel it before the deadline. Immediate deletion can't be reversed. - [I own a team. What happens if I delete my account?](https://help.clatterlabs.com/account/delete-account/deleting-account-team-owner): Ending an owner's account doesn't automatically end the organisation. Transfer ownership first so your team keeps working. - [I scheduled deletion but didn't get an email](https://help.clatterlabs.com/account/delete-account/deletion-email-not-sent): The deletion is still scheduled. Check Notifications in the account center; the email may have failed or gone to spam. - [Should I delete my account now or schedule it for 30 days?](https://help.clatterlabs.com/account/delete-account/delete-now-or-in-30-days): Scheduling gives you 30 days to change your mind. Delete immediately only if you're certain; it can't be undone. - [What happens to my plan and credits if I delete my account?](https://help.clatterlabs.com/account/delete-account/deleting-account-plan-and-credits): They're lost with the account. Cancel any subscription first and use or request refunds of credits before deleting. - [What happens when I delete my account?](https://help.clatterlabs.com/account/delete-account/what-happens-when-i-delete): Your data is deleted from every Clatter Labs service, API keys stop working, and only legally required records are kept. - [Will my account be closed if I don't use it?](https://help.clatterlabs.com/account/delete-account/inactive-account-closed): A free account inactive for more than 24 months may be closed, after at least 30 days' notice to your email. ### Teams and organizations - [How does my account work inside a team?](https://help.clatterlabs.com/account/teams/how-accounts-work-in-teams): You keep your own personal account. As a team member you use the owner's plan and credits within the access and limits the owner sets. - [What can my team owner see about me?](https://help.clatterlabs.com/account/teams/what-team-owner-can-see): Your name, email, role, access settings and the usage attributed to you, plus admin actions in the team audit log. Not your password or 2FA. - [What happens to my account if I leave a team or I'm removed?](https://help.clatterlabs.com/account/teams/leave-a-team): Your account keeps existing. The team keeps the usage records attributed to you for its billing and audit. ### Troubleshooting - ["This session reached its 15-day security limit"](https://help.clatterlabs.com/account/troubleshooting/session-reached-15-day-limit): For security, sessions end after 15 days. Sign in again; nothing is wrong with your account. - [accounts.clatterlabs.com won't load or shows "Something went wrong"](https://help.clatterlabs.com/account/troubleshooting/account-page-wont-load): Refresh, try another browser or a private window, disable extensions and check the status page's Account center component. - [Can I have my two-factor codes on two devices?](https://help.clatterlabs.com/account/troubleshooting/two-factor-on-two-phones): Yes, if you add the same QR code or setup key to both authenticator apps during setup. Treat both devices as keys to your account. - [Can I schedule my account deletion for a different date?](https://help.clatterlabs.com/account/troubleshooting/schedule-deletion-other-date): The account center offers deletion now or after a 30-day recovery period. Contact support if you need something else. - [Can I stay signed in on several devices at the same time?](https://help.clatterlabs.com/account/troubleshooting/many-devices-at-once): Yes. Each device has its own session, listed in Devices and Sessions, and you can revoke any of them separately. - [Can I use Clatter Labs without an email address?](https://help.clatterlabs.com/account/troubleshooting/no-email-address): No. Every account has an email address, which receives sign-in codes, password resets and security alerts. - [Clatter Labs doesn't work when I use a VPN](https://help.clatterlabs.com/account/troubleshooting/vpn-blocked): Some locations are blocked and using a VPN to get around restrictions isn't allowed. Turn it off if you're in a supported country. - [How do I close the account of someone who has died?](https://help.clatterlabs.com/account/troubleshooting/account-after-death): Email support with the account email or Account ID and your relationship. We'll explain what we need to close it. - [I can't sign in to my Clatter Labs account](https://help.clatterlabs.com/account/troubleshooting/i-cant-sign-in): Try an email code, check you're using the right email and sign-in method, and check the status page. Then contact support. - [I deleted my GitHub (or Vercel, Hugging Face) account. Can I still get into Clatter Labs?](https://help.clatterlabs.com/account/troubleshooting/github-account-deleted): Usually yes. Your Clatter Labs account is separate; sign in with a code sent to the same email address. - [I got a new sign-in alert, and it wasn't me](https://help.clatterlabs.com/account/troubleshooting/new-sign-in-wasnt-me): Someone may have your password or email access. Revoke the session, change your password, turn on 2FA and contact support. - [I lost access to the email on my account](https://help.clatterlabs.com/account/troubleshooting/lost-access-to-my-email): Sign in another way (password or GitHub, Vercel, Hugging Face) and update your details, or contact support to verify you. - [I signed in and my account looks empty](https://help.clatterlabs.com/account/troubleshooting/signed-in-to-wrong-account): You probably signed in with a different email or provider and created a second account. Sign out and use your original method. - [I'm not receiving my sign-in code email](https://help.clatterlabs.com/account/troubleshooting/not-receiving-sign-in-code): Check spam, confirm the address, wait a moment and use Resend code. Check Email delivery on the status page. - [I'm stuck on "Verify your email"](https://help.clatterlabs.com/account/troubleshooting/verify-email-stuck): Enter the 6-digit code we emailed you. Use Resend code if it expired or never arrived. - [It says "Could not continue with GitHub" (or Vercel, Hugging Face)](https://help.clatterlabs.com/account/troubleshooting/could-not-continue-with-github): The provider sign-in didn't finish. Try again, allow pop-ups and cookies for the provider, or sign in with an email code. - [My account says it's suspended or paused](https://help.clatterlabs.com/account/troubleshooting/account-suspended-message): Usually a 24-hour pause under the abuse policy, which lifts by itself. Other suspensions come with reasons and can be appealed. - [My account uses my work email and I'm leaving the job. What should I do?](https://help.clatterlabs.com/account/troubleshooting/leaving-job-work-email): Before you lose the inbox, move your account to a personal email via support, hand over team ownership, and rotate any keys you shared. - [My laptop or phone was stolen. How do I protect my account?](https://help.clatterlabs.com/account/troubleshooting/stolen-device): From another device, revoke its sessions, change your password, check API keys and connected apps, and turn on 2FA if it isn't on. - [Should my company use one shared account?](https://help.clatterlabs.com/account/troubleshooting/account-for-company): No. Accounts are personal. Each person uses their own account inside a Console team owned by the company's admin. - [Someone created an account with my email address](https://help.clatterlabs.com/account/troubleshooting/someone-made-account-with-my-email): Sign in with an email code to take control, change the password, turn on 2FA, or delete the account. Tell support. - [The security check on the sign-in page won't load](https://help.clatterlabs.com/account/troubleshooting/security-check-wont-load): A content blocker is usually stopping it. Allow the challenge domain named in the message, or continue with GitHub, Vercel or Hugging Face. - [What's the difference between Cloud ID and Account ID?](https://help.clatterlabs.com/account/troubleshooting/whats-my-cloud-id): They're the same thing: the permanent CL-… code for your account. Consent screens call it Cloud ID; the Console calls it Account ID. - [Where are my cookie settings?](https://help.clatterlabs.com/account/troubleshooting/cookie-settings): Open Data in the account center and choose Cookie settings to review how cookies are used on this device. ## Plans & billing Plans, usage and resets, credit packs, the trial, checkout, refunds, invoices and limits. ### Billing basics - [Billing glossary: what do these billing terms mean?](https://help.clatterlabs.com/billing/basics/billing-glossary): Short definitions: plan, credits, usage window, weekly limit, monthly allowance, list price, top-up, grant, merchant of record. - [Billing quick reference for developers](https://help.clatterlabs.com/billing/basics/billing-for-developers-quick-reference): One page of billing facts for developers: what's metered, error codes, prices, headers and the account endpoint. - [Can Clatter Labs change its prices?](https://help.clatterlabs.com/billing/basics/price-change-notice): Yes, with at least 30 days' notice for price increases affecting an active subscription. You can cancel before it applies. - [Can I get a surprise bill from Clatter Labs?](https://help.clatterlabs.com/billing/basics/can-i-get-a-surprise-bill): No. Plans are a fixed monthly price and API usage is prepaid from credits, so spending stops at zero instead of billing you later. - [Do cheaper plans get worse models?](https://help.clatterlabs.com/billing/basics/every-model-on-every-plan): No. Every plan, Free included, has SuperCosmos Flash, Max and Heavy and every tool. Bigger plans give more usage. - [Do I need a credit card to use the Free plan?](https://help.clatterlabs.com/billing/basics/no-card-needed-for-free): No. The Free plan and the $5 free credit need no payment details. You pay only when you buy a plan or credits. - [Does Code Buckets use my credits?](https://help.clatterlabs.com/billing/basics/does-code-buckets-use-credits): No. Code Buckets uses your plan's storage and 1,000,000 Code Buckets tokens a month. Credits aren't spent on it. - [Does Cosmos Agent on Telegram use credits?](https://help.clatterlabs.com/billing/basics/does-telegram-use-credits): No. Telegram usage counts toward your plan, together with Line CLI and Cosmos Agent. It also has its own daily limit. - [How do I explain Clatter Labs costs to my parents?](https://help.clatterlabs.com/billing/basics/explain-billing-to-my-parents): A short, plain explanation a teen can share: the free plan, optional monthly plans, and prepaid credits that can't overspend. - [How do plans and credits work together?](https://help.clatterlabs.com/billing/basics/plans-and-credits-explained): Your plan covers app usage (Line CLI, Cosmos Agent, Telegram, Code Buckets storage). Credits pay for the Model API and Agent API. - [How does Clatter Labs billing work for a company?](https://help.clatterlabs.com/billing/basics/billing-for-companies-overview): One owner account buys a plan for app usage and credits for API usage; employees join as team members with limits. - [How does Clatter Labs billing work, in simple words?](https://help.clatterlabs.com/billing/basics/billing-in-simple-words): A beginner-friendly explanation: your plan is like a membership for the apps, credits are like a wallet for your own programs. - [What currency are Clatter Labs prices and credits in?](https://help.clatterlabs.com/billing/basics/billing-currency): US dollars. Credits are a US-dollar balance; plan prices are in USD. Gumroad may show local taxes at checkout. - [What do credits pay for?](https://help.clatterlabs.com/billing/basics/what-credits-cover): Credits pay for the Model API, the Agent API (tokens plus computer, browser, actions and storage) and the Console Playground. - [What does "list price" mean in Clatter Labs billing?](https://help.clatterlabs.com/billing/basics/what-is-list-price): List price is what usage is worth at the published model rates, used both for charging credits and for measuring plan usage. - [What does a new Clatter Labs account get for free?](https://help.clatterlabs.com/billing/basics/what-a-new-account-gets): The Free plan (every model and tool, a monthly allowance, 1 GB Code Buckets) plus $5 of free API credit, once. - [What does Billing › Overview show?](https://help.clatterlabs.com/billing/basics/billing-overview-tab): Your current plan and status, API credits, usage meters (window, week or month) and Code Buckets storage. - [What exactly does my plan pay for?](https://help.clatterlabs.com/billing/basics/what-the-plan-covers): App usage across Line CLI, Cosmos Agent and Cosmos Agent on Telegram, plus your Code Buckets storage. Not API calls. - [What happens if I never pay for anything?](https://help.clatterlabs.com/billing/basics/what-if-i-never-pay): Nothing bad. You stay on Free with its monthly allowance, 1 GB of Code Buckets and whatever is left of your $5 free credit. - [What's on the Console Billing page?](https://help.clatterlabs.com/billing/basics/billing-page-tour): Billing has five tabs: Overview, Plans, Credits, Usage and History, plus a Refresh payment status button. - [Which account pays for usage?](https://help.clatterlabs.com/billing/basics/which-account-pays): The account that owns the API key or that you're signed in with. On a team, the team owner's plan and credits pay. - [Why are there separate plans and credits instead of one bill?](https://help.clatterlabs.com/billing/basics/why-two-systems): Apps get predictable monthly usage that resets; APIs are pay as you go so developers pay exactly for what their code uses. ### Plans - [Are plans billed monthly or yearly?](https://help.clatterlabs.com/billing/plans/plans-are-monthly): Plans are monthly memberships that renew automatically each month until you cancel. No yearly option is published. - [Can I have two plans on one account?](https://help.clatterlabs.com/billing/plans/two-plans-at-once): No. An account has one plan. Change plans from Billing; separate accounts or a team are the way to have more. - [Can I try a paid plan before paying?](https://help.clatterlabs.com/billing/plans/can-i-try-a-paid-plan): No free trial of paid plans is published. Free includes every model and tool, so you can test the products before upgrading. - [Did plan limits change with SuperCosmos 1.1?](https://help.clatterlabs.com/billing/plans/limits-raised-with-supercosmos-1-1): Yes. On Nov 2, 2026 every paid plan's window and weekly limits went up 25%. Free keeps 1M tokens a month; prices didn't change. - [Does a bigger plan make the models faster or smarter?](https://help.clatterlabs.com/billing/plans/does-a-bigger-plan-make-it-faster): No. Every plan gets the same models. A bigger plan gives more usage and shorter windows, not different answers. - [Does a plan's price include API credits or extra storage?](https://help.clatterlabs.com/billing/plans/plan-price-includes-what): No. A plan's price covers app usage and its listed Code Buckets storage. API calls always use credits bought separately. - [Does the Free plan expire?](https://help.clatterlabs.com/billing/plans/does-free-plan-expire): No. Free has no end date. Its allowance resets on the 1st of every month (UTC). - [How much Code Buckets storage does each plan include?](https://help.clatterlabs.com/billing/plans/code-buckets-storage-per-plan): Free 1 GB, Developer 25 GB, Plus 50 GB, Pro 150 GB, Max 400 GB, Ultra 1 TB. Every plan: 1M tokens a month, 1 backup, 10 GB per bucket. - [I only use the Model API or Agent API. Do I need a paid plan?](https://help.clatterlabs.com/billing/plans/plan-for-api-only-users): No. API usage is paid from credits on every plan. Stay on Free and top up credits. - [Is Cosmos Agent on Telegram included in every plan?](https://help.clatterlabs.com/billing/plans/plan-includes-telegram): Yes. Telegram is included on every plan, Free too, and counts toward your plan's usage, with its own daily limit. - [Is it worth upgrading from Free to Developer?](https://help.clatterlabs.com/billing/plans/free-vs-developer): Developer ($15) gives about 15× Free's usage, refilling every 5.5 hours and weekly instead of once a month, plus 25 GB storage. - [Is the "Max" plan the same as the SuperCosmos "Max" effort?](https://help.clatterlabs.com/billing/plans/plan-max-vs-effort-max): No. Max is a $100/month plan. SuperCosmos Max is an effort (tier) that every plan, including Free, can use. - [My plan says "granted by Clatter Labs at no charge". What does that mean?](https://help.clatterlabs.com/billing/plans/granted-plan): Clatter Labs gave your account a plan for free until a set date. It works like a paid plan and ends on that date. - [Should I choose Developer or Plus?](https://help.clatterlabs.com/billing/plans/developer-vs-plus): Plus costs $10 more and gives about 2.5× Developer's usage with the same 5.5-hour window and twice the storage (50 GB vs 25 GB). - [Should I choose Max or Ultra?](https://help.clatterlabs.com/billing/plans/max-vs-ultra): Ultra ($200) gives about 2.2× Max's usage, a 1.5-hour window instead of 2 hours, and 1 TB of storage instead of 400 GB. - [Should I choose Pro or Max?](https://help.clatterlabs.com/billing/plans/pro-vs-max): Max ($100) gives about 2.3× Pro's usage and a 2-hour window instead of 5 hours, plus 400 GB storage instead of 150 GB. - [What do "≈15× Free usage" and the other multiples mean?](https://help.clatterlabs.com/billing/plans/what-usage-multiples-mean): They compare how much app usage each plan gives with Free and with the plan below, for typical use across the models. - [What do the buttons on the plan cards mean?](https://help.clatterlabs.com/billing/plans/plan-buttons-explained): Get opens checkout; Current plan / Manage for your plan; Change to for subscribers; Opens soon; Team plan. - [What do the columns in the Compare plans table mean?](https://help.clatterlabs.com/billing/plans/compare-table-columns): vs Free, vs plan below, vs Developer, Per window (vs Developer), Window length, Weekly reset and Storage. - [What happened to the Starter plan and the old daily limits?](https://help.clatterlabs.com/billing/plans/legacy-plan-names): On Oct 31, 2026 plans changed to Free, Developer, Plus, Pro, Max and Ultra, with usage windows and a weekly limit. - [What if I pick the wrong plan?](https://help.clatterlabs.com/billing/plans/what-if-i-pick-the-wrong-plan): Change it from Billing. Upgrades go through your Gumroad subscription; downgrades take effect next billing period. - [What is the "Enterprise" plan I see on some accounts?](https://help.clatterlabs.com/billing/plans/what-is-enterprise): Enterprise is an internal unlimited plan for Clatter Labs' own team accounts. It isn't sold and isn't on the Plans page. - [What plans does Clatter Labs offer and how do they compare?](https://help.clatterlabs.com/billing/plans/compare-plans): Free $0, Developer $15, Plus $25, Pro $50, Max $100 and Ultra $200 a month: usage, window resets, weekly reset and storage. - [What's included in the Developer plan?](https://help.clatterlabs.com/billing/plans/developer-plan): $15/month: about 15× Free usage, a usage window that resets every 5.5 hours, a weekly reset, 25 GB Code Buckets. - [What's included in the Free plan?](https://help.clatterlabs.com/billing/plans/free-plan): $0: every model and tool, Line CLI, Cosmos Agent and Telegram with a monthly allowance, 1 GB Code Buckets, APIs pay as you go. - [What's included in the Max plan?](https://help.clatterlabs.com/billing/plans/max-plan): $100/month: about 125× Free (≈2.3× Pro), window resets every 2 hours, weekly reset, 400 GB Code Buckets. - [What's included in the Plus plan?](https://help.clatterlabs.com/billing/plans/plus-plan): $25/month: about 35× Free (≈2.5× Developer), window resets every 5.5 hours, weekly reset, 50 GB Code Buckets. - [What's included in the Pro plan?](https://help.clatterlabs.com/billing/plans/pro-plan): $50/month: about 55× Free (≈1.6× Plus), window resets every 5 hours, weekly reset, 150 GB Code Buckets. - [What's included in the Ultra plan?](https://help.clatterlabs.com/billing/plans/ultra-plan): $200/month: about 280× Free (≈2.2× Max), window resets every 1.5 hours, weekly reset, 1 TB Code Buckets. - [What's on the Billing › Plans page?](https://help.clatterlabs.com/billing/plans/plans-page-explained): The list of what every plan includes, the Free card, paid plan cards with buttons, a Compare plans table and How plans work. - [Which plan is best for a student or beginner?](https://help.clatterlabs.com/billing/plans/plan-for-students): Free is enough to learn: every model and tool, a monthly allowance and $5 of API credit. Developer is the first paid step. - [Which plan should I choose?](https://help.clatterlabs.com/billing/plans/which-plan-should-i-choose): Start on Free. Move up when you keep hitting limits: check how often the window or week fills in Billing, then pick the next step. - [Which plan suits a small team of developers?](https://help.clatterlabs.com/billing/plans/plan-for-a-small-team): Pick by total usage: the whole team shares one plan. Many small teams start on Plus or Pro and use member quotas. - [Which plan suits someone who runs Cosmos Agent or Line CLI all day?](https://help.clatterlabs.com/billing/plans/plan-for-heavy-agent-users): Max or Ultra: the most usage per window and per week, and the shortest windows (2 h and 1.5 h) that refill fastest. - [Why doesn't Clatter Labs publish exact plan limits?](https://help.clatterlabs.com/billing/plans/why-no-exact-limits): Plans are shown as % used, reset times and relative multiples. The Console shows exactly where you stand, not a fixed amount. ### Usage limits and resets - [Are Line CLI, Cosmos Agent and Telegram limits separate?](https://help.clatterlabs.com/billing/usage-limits/limits-are-shared-across-apps): No. They share one set of plan limits. Telegram also has its own extra daily limit. - [Can I reset my usage window early?](https://help.clatterlabs.com/billing/usage-limits/time-travel-question): No. Windows reset at the end of their length, weeks after 7 days, and Free on the 1st (UTC). Upgrading gives more usage. - [Do Line CLI sub-agents use more of my plan?](https://help.clatterlabs.com/billing/usage-limits/sub-agents-and-limits): Yes. Each sub-agent makes its own model calls, which all count toward your plan's limits at list price. - [Do Model API or Agent API calls count toward my plan limits?](https://help.clatterlabs.com/billing/usage-limits/does-api-count-toward-plan): No. API calls are paid from credits and never use your plan's windows, weekly limit or monthly allowance. - [Does choosing Heavy use my plan up faster than Flash?](https://help.clatterlabs.com/billing/usage-limits/effort-and-limits): Yes. Usage is measured at list price, and Heavy costs more per token and writes more, so the same task uses more of your limit. - [Does Cosmos Agent on Telegram have its own limit?](https://help.clatterlabs.com/billing/usage-limits/telegram-daily-limit): Yes. Besides your plan's limits, Telegram keeps its own daily limit per account. Whichever is reached first applies. - [Does my usage window keep running when I'm not using anything?](https://help.clatterlabs.com/billing/usage-limits/limits-while-asleep): A started window runs to its end even if you stop. After it ends, no new window starts until your next request. - [Does unused usage roll over to the next window or week?](https://help.clatterlabs.com/billing/usage-limits/do-unused-limits-roll-over): No. Unused usage doesn't carry over to the next window, week or month unless the plan says otherwise. - [How do I check how much of my plan I've used?](https://help.clatterlabs.com/billing/usage-limits/check-plan-usage): Console Home and Billing show % used and reset times; Line CLI has /usage and /cost; Telegram has /usage. - [How do I check my plan usage from Line CLI?](https://help.clatterlabs.com/billing/usage-limits/check-usage-in-line-cli): Run /usage for % used and reset times (window and week, or month on Free) plus API credits; /cost for this session's cost. - [How do I read the usage meters in Billing?](https://help.clatterlabs.com/billing/usage-limits/read-the-usage-meters): Each meter shows % used, a bar, a status pill (Available, Almost used, Limit reached), the reset time and the time left. - [How do plan limits work when I'm on a team?](https://help.clatterlabs.com/billing/usage-limits/usage-limits-on-a-team): Everyone on the team shares the owner's plan limits. The owner can also give each member a daily quota and monthly limit. - [How do usage windows work on paid plans?](https://help.clatterlabs.com/billing/usage-limits/how-usage-windows-work): A window starts with your first request after the previous one ended and lasts 1.5 to 5.5 hours depending on your plan. - [How does the Free plan's monthly allowance work?](https://help.clatterlabs.com/billing/usage-limits/free-monthly-allowance): Free has one monthly allowance (1M tokens a month) that resets on the 1st of every month, UTC. No windows or weekly limit. - [How does the weekly limit work?](https://help.clatterlabs.com/billing/usage-limits/weekly-limit): On paid plans, the weekly limit runs for 7 days from your billing date, then starts again, on top of your usage windows. - [How is plan usage measured?](https://help.clatterlabs.com/billing/usage-limits/how-usage-is-measured): As what your app requests would cost at model rates, across Line CLI, Cosmos Agent and Telegram together, shown as % used. - [How long is the usage window on each plan?](https://help.clatterlabs.com/billing/usage-limits/window-lengths-per-plan): Developer 5.5 h, Plus 5.5 h, Pro 5 h, Max 2 h, Ultra 1.5 h. Free has a monthly allowance instead. - [I have several limits. Which one stops me first?](https://help.clatterlabs.com/billing/usage-limits/which-limit-applies-first): Whichever fills first: the usage window, the weekly limit, a team quota or Telegram's daily limit. Each blocks on its own. - [If I stop a Line CLI request halfway, does it still count?](https://help.clatterlabs.com/billing/usage-limits/does-cancelling-a-request-save-usage): Yes, for what it already used. Usage is measured on the tokens actually processed and generated before you stopped. - [If I upgrade in the middle of a window, what happens to my current window?](https://help.clatterlabs.com/billing/usage-limits/usage-on-two-plans-same-day): Clatter Labs doesn't publish how a mid-window upgrade is handled. Check the meters in Billing after the upgrade shows. - [If I use Line CLI on two computers, do I get two allowances?](https://help.clatterlabs.com/billing/usage-limits/what-if-i-use-two-devices): No. Limits belong to your account, not the device. All your devices and apps share the same window, week or month. - [Is the usage shown in the Console the official record?](https://help.clatterlabs.com/billing/usage-limits/console-usage-vs-official-record): Console figures are for convenience and may be delayed. Server-side metering is authoritative; disputes within 60 days. - [What are usage limits, in simple words?](https://help.clatterlabs.com/billing/usage-limits/limits-for-beginners): Limits are how much AI help your plan gives you before you wait for a refill: a few hours on paid plans, the month on Free. - [What does "Almost used" on a usage meter mean?](https://help.clatterlabs.com/billing/usage-limits/almost-used-warning): You've used 80% or more of that limit. Switch to lighter efforts, slow down, or upgrade before you hit it. - [What happens to my usage when my plan ends or changes?](https://help.clatterlabs.com/billing/usage-limits/unused-plan-ending): Limits follow your current plan. When a paid plan ends, you go back to Free's monthly allowance; nothing carries over. - [What happens when a usage meter reaches 100%?](https://help.clatterlabs.com/billing/usage-limits/what-happens-at-100-percent): New app requests answer 429 until the reset; Line CLI shows when. API calls with credits keep working. - [When do my usage limits reset?](https://help.clatterlabs.com/billing/usage-limits/when-do-limits-reset): Paid windows reset at the end of their 1.5–5.5 h length; weekly 7 days from your billing date; Free on the 1st (UTC). - [Why did my usage window fill up so quickly?](https://help.clatterlabs.com/billing/usage-limits/why-did-my-limit-fill-fast): Heavy effort, very long context, big files or many sub-agents use more. Switch everyday steps to Flash and trim context. - [Why do I have to wait before I can use Line CLI again?](https://help.clatterlabs.com/billing/usage-limits/kids-question-why-wait): Your plan's usage for now is used up. It refills by itself at the reset time shown in Line or in the Console. - [Why does Billing show percentages instead of dollars or tokens?](https://help.clatterlabs.com/billing/usage-limits/why-percent-only): Plan limits are published as % used with a reset time. Free's 1M tokens a month is the one fixed figure. - [Why does my usage window say "Not started"?](https://help.clatterlabs.com/billing/usage-limits/window-not-started): No window is running right now. The next one starts with your next request and runs for your plan's window length. - [Why was a request refused even though I hadn't quite reached my limit?](https://help.clatterlabs.com/billing/usage-limits/request-refused-before-running): Clatter Labs may estimate a request's maximum cost first and refuse it if your remaining quota or credits can't cover it. ### Limit and quota errors - [Can the Model API return window_limit_reached?](https://help.clatterlabs.com/billing/limit-errors/limit-error-on-api): No. Plan limit errors are for app usage. API calls are only stopped by credits (402), key rate limits or team caps. - [How should my code handle 429 and 402 billing errors?](https://help.clatterlabs.com/billing/limit-errors/handle-limit-errors-in-code): Branch on error.code: wait Retry-After for rate limits, wait resets_at for plan and team limits, stop and alert on 402. - [I got 403 plan_required or model_not_in_plan from an old tool. What now?](https://help.clatterlabs.com/billing/limit-errors/plan-required-error-gone): Those errors were removed on Oct 31, 2026. Every plan has every model and API access. Update your tool. - [What are resets_at and Retry-After in limit errors?](https://help.clatterlabs.com/billing/limit-errors/resets-at-field): resets_at is the UTC time the limit clears; Retry-After is the number of seconds until then. - [What does 402 quota_exceeded mean in Code Buckets?](https://help.clatterlabs.com/billing/limit-errors/code-buckets-quota-exceeded): Your 1,000,000 Code Buckets tokens for this UTC month are used. Requests resume next month. Contact support for more. - [What does 402 storage_full mean when uploading?](https://help.clatterlabs.com/billing/limit-errors/code-buckets-storage-full): The upload would go past your plan's total Code Buckets storage. Delete files or upgrade to a plan with more storage. - [What does 429 monthly_limit_reached mean?](https://help.clatterlabs.com/billing/limit-errors/monthly-limit-reached): You've used the Free plan's monthly allowance. It resets on the 1st (UTC). Upgrade for usage that refills every few hours. - [What does 429 team_daily_quota_reached mean?](https://help.clatterlabs.com/billing/limit-errors/team-daily-quota-reached): You're on a team and reached the daily quota your team owner set. It resets daily; ask the owner to raise it. - [What does 429 team_spend_limit_reached mean?](https://help.clatterlabs.com/billing/limit-errors/team-spend-limit-reached): You reached the monthly spending limit your team owner set for you. It resets monthly; the owner can raise it. - [What does 429 weekly_limit_reached mean?](https://help.clatterlabs.com/billing/limit-errors/weekly-limit-reached): You've used your paid plan's weekly limit. It resets 7 days from your billing date; upgrade for more weekly usage. - [What does 429 window_limit_reached mean?](https://help.clatterlabs.com/billing/limit-errors/window-limit-reached): You've used your current usage window on a paid plan. Wait until resets_at, or upgrade for more usage per window. - [What does it look like when I hit a limit on Telegram?](https://help.clatterlabs.com/billing/limit-errors/limit-error-in-telegram): Cosmos tells you in the chat. Check /usage on Telegram or Billing in the Console to see which limit and when it resets. - [What happens if my code ignores Retry-After and keeps retrying?](https://help.clatterlabs.com/billing/limit-errors/what-if-i-ignore-retry-after): Each retry fails the same way until the reset, and it uses your key's per-minute rate limit. Wait for resets_at. - [What's the difference between rate_limited and a plan limit?](https://help.clatterlabs.com/billing/limit-errors/rate-limited-vs-plan-limit): rate_limited is about speed: requests per minute per key. Plan limits are about total app usage over a window, week or month. ### Credits - [Can a team member buy credits for the team?](https://help.clatterlabs.com/billing/credits/members-cannot-buy-credits): No. Members see "Team credits" and can't add credits. Only the team owner can top up. - [Can credits top up automatically?](https://help.clatterlabs.com/billing/credits/auto-top-up): No automatic top-up is offered. Watch the API credits card, low-credit Inbox messages and GET /v1/account, and top up by hand. - [Can I buy credits for someone else's account?](https://help.clatterlabs.com/billing/credits/buy-credits-for-someone-else): Credits are linked to the Account ID in the checkout link. Buy from your own Console, or invite the person to your team. - [Can I buy credits in cents, like $7.50?](https://help.clatterlabs.com/billing/credits/whole-dollars-only): No. Purchases are whole dollar amounts from $1 to $800. The form only accepts whole numbers. - [Can I exchange credits for cash?](https://help.clatterlabs.com/billing/credits/credits-cash-value): No. Credits have no cash value and can't be exchanged for cash. Unused purchased credits may be refundable within 14 days. - [Can I move credits to another account?](https://help.clatterlabs.com/billing/credits/move-credits-between-accounts): No. Credits belong to one Account ID and can't be transferred. Teams let others use your credits instead. - [Can my credit balance go below zero?](https://help.clatterlabs.com/billing/credits/negative-balance): Normally metered calls stop at zero with 402. A reversed payment or chargeback can be deducted from your balance. - [Do credits expire?](https://help.clatterlabs.com/billing/credits/do-credits-expire): The Console and docs state that credits don't expire. Promotional credits follow the terms stated when they're granted. - [Do I lose my credits if I change or cancel my plan?](https://help.clatterlabs.com/billing/credits/credits-on-plan-change): No. Credits are separate from your plan and stay on your account whatever plan you're on. - [Do I need credits just to try the Playground?](https://help.clatterlabs.com/billing/credits/credits-for-playground-only): Yes, the Playground uses credits, but new accounts have $5 of free credit, which covers many test chats. - [How do I buy credits?](https://help.clatterlabs.com/billing/credits/add-credits): Billing › Credits: pick or type a whole amount from $1 to $800, select Buy, and pay at Gumroad. Credits land within seconds. - [How do I check my credit balance from code?](https://help.clatterlabs.com/billing/credits/check-balance-with-the-api): Call GET /v1/account with an account:read key and your Account ID. It returns balance_usd, out_of_credits and 30-day usage. - [How do I check my credit balance?](https://help.clatterlabs.com/billing/credits/check-credit-balance): Console Home (API credits card), Billing › Overview and Credits, the Models page, Line CLI /usage, or GET /v1/account. - [How much credit can I buy at once?](https://help.clatterlabs.com/billing/credits/credit-amounts): Any whole dollar amount from $1 to $800 per purchase. Every $1 adds $1. Buy again if you need more. - [How much credit should I buy for a hackathon or a demo?](https://help.clatterlabs.com/billing/credits/credits-for-a-hackathon): Estimate requests × typical cost, add a buffer, and remember the $5 free credit. Top-ups land in seconds if you run low. - [I bought credits but my balance didn't go up. What should I do?](https://help.clatterlabs.com/billing/credits/credits-not-showing): Select Refresh payment status, check Credit purchases, check you're in the right account, then contact support with the receipt. - [I have both an old Model API trial and credits. Which is used?](https://help.clatterlabs.com/billing/credits/what-if-credits-and-trial): The old trial is used first for Model API calls, then free credit, then purchased credits. - [If I buy credits, do I get more Line CLI usage?](https://help.clatterlabs.com/billing/credits/credits-and-plan-are-separate): No. Credits only pay for the Model API, Agent API and Playground. More Line CLI usage needs a bigger plan. - [Is free credit used before the credits I bought?](https://help.clatterlabs.com/billing/credits/free-credit-used-first): Yes. Promotional and free credits are used before purchased credits unless stated otherwise; an old Model API trial goes first. - [Is it worth buying just $1 of credits?](https://help.clatterlabs.com/billing/credits/what-if-i-buy-1-dollar): Yes, $1 is the minimum and buys plenty of short API calls; for example about 300 short Flash chats at 1,000 in / 500 out. - [What are Clatter Labs credits?](https://help.clatterlabs.com/billing/credits/what-are-credits): A prepaid US-dollar balance, one per Account ID, that pays for the Model API, the Agent API and the Playground. - [What do the statuses in Credit purchases mean?](https://help.clatterlabs.com/billing/credits/credit-purchase-statuses): credited means added; refunded means removed again; "Above $800, being refunded" was over the limit; others are in progress. - [What happened to the $10, $25, $50 and $100 credit packs?](https://help.clatterlabs.com/billing/credits/old-credit-packs): Fixed packs were replaced on Oct 31, 2026 by any whole amount from $1 to $800. Credits from packs work the same. - [What happens if I pay more than $800 for credits in one purchase?](https://help.clatterlabs.com/billing/credits/purchase-above-800): A purchase above $800 isn't credited. It shows "Above $800, being refunded" and is refunded. - [What if I need credits and checkout isn't working?](https://help.clatterlabs.com/billing/credits/what-if-gumroad-is-down): Your existing credits keep working. Try again later, check the status page's Payments group, and contact support if urgent. - [What is the "Model API trial" in my billing?](https://help.clatterlabs.com/billing/credits/old-model-api-trial): Some older accounts got a one-time $5 Model API trial. What's left is used before your credits. New accounts get $5 free credit instead. - [What is the $5 free credit?](https://help.clatterlabs.com/billing/credits/five-dollar-free-credit): Every new account gets $5 of credit once, for the Model API and Agent API. It replaced the old $20 grant and $5 Model API trial. - [What's on the Billing › Credits tab?](https://help.clatterlabs.com/billing/credits/credits-page-explained): Your API credit balance, free and granted, bought, spent on API calls, the Add credits form and your credit purchases. - [Where did my credits go?](https://help.clatterlabs.com/billing/credits/where-did-my-credits-go): Check Billing › History for daily API usage rows, Logs filtered to Model API and Agent API, and Usage by product. ### What API usage costs - [Am I charged for calls to retired Line Code ids?](https://help.clatterlabs.com/billing/api-costs/line-code-not-billed): No. Line Code ids answer 410 model_retired and are never billed. Switch to a SuperCosmos id. - [Am I charged for requests that fail?](https://help.clatterlabs.com/billing/api-costs/what-is-billed-for-a-failed-call): Requests refused up front aren't billed. Retired ids are never billed. Partly completed work is billed for what it used. - [Am I charged for the model's thinking?](https://help.clatterlabs.com/billing/api-costs/reasoning-tokens): Yes. Output tokens include reasoning tokens. Max and Heavy think more than Flash, so they usually write more output tokens. - [Can you show an example of what an API call costs?](https://help.clatterlabs.com/billing/api-costs/cost-example): Worked examples: a 1,000-in / 500-out Flash chat, and the docs' Max run example of 9,696 in and 38 out (≈ $0.0176). - [Does a long system prompt cost money on every request?](https://help.clatterlabs.com/billing/api-costs/system-prompt-cost): Yes. The system prompt is part of the input on every call, so a long one adds input tokens each time. - [Does setting max_tokens lower my cost?](https://help.clatterlabs.com/billing/api-costs/max-tokens-and-cost): It caps the most a single answer can cost, because you never pay for more output than the cap. Short answers cost the same either way. - [Does streaming a response cost more than a normal response?](https://help.clatterlabs.com/billing/api-costs/does-streaming-cost-more): No. Streaming and non-streaming calls are billed the same way: by input and output tokens at the model's price. - [Does using tool calling on the Model API cost extra?](https://help.clatterlabs.com/billing/api-costs/do-tools-cost-extra): No separate fee. Tool definitions and results are part of the input and output tokens, which are billed normally. - [How can I spend less on API calls?](https://help.clatterlabs.com/billing/api-costs/choose-a-tier-to-save): Use Flash by default, move up only when needed, keep context short, stream instead of polling, and set team limits. - [How do I budget for thousands of API requests?](https://help.clatterlabs.com/billing/api-costs/cost-for-many-requests): Measure a typical request's tokens, multiply by the price and by your volume, then add a buffer. Check with real usage. - [How do I estimate what an Agent API run will cost?](https://help.clatterlabs.com/billing/api-costs/estimate-an-agent-run): Add tokens at the tier's price plus computer minutes, actions, browser minutes and storage. Try it in the Playground first. - [How do I know which price list applies?](https://help.clatterlabs.com/billing/api-costs/rates-version): The Rates page shows a rates version. Credits are charged at the prices in effect when you use them. - [How is an Agent API run on tier "auto" billed?](https://help.clatterlabs.com/billing/api-costs/auto-tier-billing): A run with tier auto is billed at Flash rates. Runs set to max or heavy bill at those tiers. - [How is the cost of a Model API call worked out?](https://help.clatterlabs.com/billing/api-costs/how-a-call-is-priced): Input tokens × input price + output tokens × output price for the model id you called, rounded up to the next millionth of a dollar. - [How much does SuperCosmos cost per token?](https://help.clatterlabs.com/billing/api-costs/supercosmos-prices): Per 1M tokens in/out: Flash $1.60/$3.40, Max $1.80/$3.80, Heavy $2.00/$4.40. Input above 262K tokens bills 1.5×. - [If I cancel an Agent API run, do I still pay?](https://help.clatterlabs.com/billing/api-costs/cancel-a-run-billing): You pay for the tokens, computer time and actions used up to the cancellation. Nothing after that. - [Is SuperCosmos expensive to use through the API?](https://help.clatterlabs.com/billing/api-costs/is-it-expensive): Prices start at $1.60 per million input tokens. Typical short calls cost a fraction of a cent; long agent runs cost more. - [Is SuperCosmos the same price in every product?](https://help.clatterlabs.com/billing/api-costs/price-same-everywhere): Yes. The same per-token rates apply on the Agent API, Model API, Line CLI and Cosmos Agent. - [What counts as cloud computer time on an Agent API run?](https://help.clatterlabs.com/billing/api-costs/agent-computer-time): Time the run's cloud computer spends running commands and file work, billed at $0.006 per minute. - [What does an Agent API run cost besides tokens?](https://help.clatterlabs.com/billing/api-costs/agent-api-extra-charges): Cloud computer $0.006/min, edits and tool actions $0.0005 each, cloud browser $0.005/min, storage writes $0.10/GB. - [What if I send a prompt close to the 1M-token context window?](https://help.clatterlabs.com/billing/api-costs/what-if-prompt-is-huge): It works up to the window, but input above 262K tokens bills at 1.5×, and Model API requests are capped at 3 MB and 800 messages. - [What is a token in Clatter Labs pricing?](https://help.clatterlabs.com/billing/api-costs/what-is-a-token): A token is a small piece of text, roughly part of a word. Models read input tokens and write output tokens, and prices are per 1M tokens. - [Which tier am I billed at in each product?](https://help.clatterlabs.com/billing/api-costs/which-tier-is-billed): Agent API: the run's tier (auto = Flash). Line CLI: the tier that answered. Model API: the id you called. Cosmos Agent: named or inferred. - [Why are my input tokens a bit higher than my prompt?](https://help.clatterlabs.com/billing/api-costs/instruction-block-tokens): Every Model API request includes a short Clatter Labs instruction block, which counts as input tokens. - [Why did the same question cost different amounts twice?](https://help.clatterlabs.com/billing/api-costs/same-question-different-cost): Answers vary in length, chats grow longer, and different tiers have different prices. Each call bills its own usage. - [Why do long prompts cost more?](https://help.clatterlabs.com/billing/api-costs/long-context-surcharge): A request whose prompt is over 262K tokens bills its whole input at 1.5× the normal rate. ### When you run out - [Can I keep using the Playground when my plan limit is reached?](https://help.clatterlabs.com/billing/running-out/playground-and-plan-limit): Yes. The Playground uses credits, not your plan, so it works as long as you have credits. - [Does running out of credits or hitting a limit delete my data?](https://help.clatterlabs.com/billing/running-out/does-running-out-delete-anything): No. Keys, Code Buckets files, Logs and settings stay. Only new metered requests are paused. - [How do I make sure my app never runs out of credits?](https://help.clatterlabs.com/billing/running-out/avoid-running-out): Monitor balance_usd with GET /v1/account, alert on a threshold, top up before big jobs, and treat 402 as an alert. - [I hit my plan limit. Can I keep working?](https://help.clatterlabs.com/billing/running-out/keep-working-at-a-limit): App usage waits until the reset or an upgrade. The Model API and Agent API keep working from credits. - [I'm on a team and get out_of_credits. What do I do?](https://help.clatterlabs.com/billing/running-out/out-of-credits-on-a-team): Team members spend the owner's credits. Ask the team owner to add credits. - [My Agent API run failed with out_of_credits. Can I continue it?](https://help.clatterlabs.com/billing/running-out/run-stopped-out-of-credits): The run stopped when credits ran out. Add credits, then start a new run; its saved files help you pick up where it left off. - [What happens if my credits run out in the middle of a streamed answer?](https://help.clatterlabs.com/billing/running-out/what-if-credits-run-out-during-a-stream): Requests are checked before they run; a request whose cost can't be covered may be refused up front with 402. - [What happens if my plan limit runs out in the middle of a Line CLI task?](https://help.clatterlabs.com/billing/running-out/running-out-mid-task-in-line): Line shows the limit message and reset time; new requests wait. Continue after the reset, or upgrade. - [What happens when I run out of credits?](https://help.clatterlabs.com/billing/running-out/out-of-credits-what-happens): API calls answer 402 out_of_credits, runs stop, and the Playground asks you to add credits. Apps keep using your plan. - [What happens when my Code Buckets storage is full?](https://help.clatterlabs.com/billing/running-out/code-buckets-storage-full): New uploads are refused with 402 storage_full; existing files stay. Delete files or upgrade. Long excess may lead to deletion after notice. - [What if I'm on Free with no credits left and the month is used up?](https://help.clatterlabs.com/billing/running-out/what-if-zero-and-free): You can still sign in, use the Console and read your files. Apps wait for the 1st (UTC); APIs need credits. - [When my credits run out, can my plan pay for API calls?](https://help.clatterlabs.com/billing/running-out/credits-do-not-extend-plan): No. Plans never cover API calls. Model API and Agent API calls need credits on every plan. - [When my plan limit runs out, does Line CLI start using my credits?](https://help.clatterlabs.com/billing/running-out/plan-does-not-spill-into-credits): No. App usage never overflows into credits. It waits for the limit to reset. - [Will I be warned before my credits run out?](https://help.clatterlabs.com/billing/running-out/low-credits-warning): The Console Inbox sends a low-credits message, and the Home card shows your live balance. Your code can check GET /v1/account. ### Checkout and payments - [Billing says "Checkout opens soon". Why can't I buy?](https://help.clatterlabs.com/billing/checkout/checkout-opens-soon): Checkout is temporarily closed. Plan buttons say Opens soon and the notice says plans and credits will be available shortly. - [Can I buy a plan or credits from my phone?](https://help.clatterlabs.com/billing/checkout/paying-from-a-phone): Yes. Open Billing in your phone's browser; Gumroad's checkout works on mobile. Allow new tabs if it opens one. - [Can I buy a plan or credits if I'm under 18?](https://help.clatterlabs.com/billing/checkout/buying-as-a-minor): Minors can only buy plans or credits through a parent or guardian. Under 13s can't have an account. - [Can I buy from any country?](https://help.clatterlabs.com/billing/checkout/restricted-countries): Clatter Labs restricts some jurisdictions under the Terms. Gumroad's checkout may also limit methods by country. - [Can I give someone a Clatter Labs plan as a gift?](https://help.clatterlabs.com/billing/checkout/gift-a-plan): There's no gift option. The person can buy from their own Console, or you can add them to your team. - [Can I pay with a different email from my Clatter Labs account?](https://help.clatterlabs.com/billing/checkout/pay-with-different-email): Yes, as long as the checkout link keeps your Account ID. Always start checkout from the Console. - [Can my business name appear on the receipt?](https://help.clatterlabs.com/billing/checkout/business-name-on-receipt): Receipts come from Gumroad, the merchant of record. Use the details Gumroad lets you enter at checkout or in its receipt. - [How do I buy a paid plan?](https://help.clatterlabs.com/billing/checkout/buy-a-plan): Billing › Plans › Get , pay at Gumroad, and the Console activates the plan within seconds of the payment. - [How does checkout work?](https://help.clatterlabs.com/billing/checkout/how-checkout-works): Plans and credits are bought in the Console and paid through Gumroad, the merchant of record. Your purchase links to your Account ID. - [I bought a plan or credits on the wrong account. Can it be moved?](https://help.clatterlabs.com/billing/checkout/bought-on-wrong-account): Purchases belong to the Account ID in the checkout link. Credits can't be transferred; email support with both Account IDs. - [I closed the checkout window before it finished. Was I charged?](https://help.clatterlabs.com/billing/checkout/what-if-checkout-closes-midway): If Gumroad didn't complete the payment, nothing was bought. Check Billing › History and your Gumroad receipt email. - [I paid for a plan but the Console still shows Free. What do I do?](https://help.clatterlabs.com/billing/checkout/plan-not-showing-after-payment): Wait a moment, select Refresh payment status, check you're in the right account, then contact support with the Gumroad receipt. - [I think I was charged twice. What should I do?](https://help.clatterlabs.com/billing/checkout/duplicate-charge): Check Billing › History and your Gumroad receipts, then email support with your Account ID and both receipts within 60 days. - [Is it safe to pay through the Console?](https://help.clatterlabs.com/billing/checkout/is-checkout-secure): Payment is handled on Gumroad's checkout; the Console doesn't ask for card numbers. Only start checkout from console.clatterlabs.com. - [My payment failed or my card was declined. What now?](https://help.clatterlabs.com/billing/checkout/payment-failed): Gumroad handles payments. Try another method or contact your bank. For renewals, update your card on Gumroad. - [The checkout window doesn't open. What can I do?](https://help.clatterlabs.com/billing/checkout/checkout-wont-open): Allow pop-ups and new tabs for the Console, disable blockers, try another browser, or check your company network. - [What does "Refresh payment status" do?](https://help.clatterlabs.com/billing/checkout/refresh-payment-status): It asks Gumroad again about your purchases and updates your plan and credits. Use it if a payment doesn't show up. - [What does "test" next to a purchase mean?](https://help.clatterlabs.com/billing/checkout/test-purchase-label): It marks a test purchase made without a real charge. It doesn't represent a payment. - [What does Gumroad get when I buy from the Console?](https://help.clatterlabs.com/billing/checkout/what-gumroad-receives): The checkout link carries your Account ID and email so the purchase matches your account. Gumroad handles your payment details. - [What happens if I file a chargeback?](https://help.clatterlabs.com/billing/checkout/chargebacks): Paid features may be suspended until the amount is paid, and reversed amounts may be deducted from credits. Ask support first. - [Which payment methods can I use?](https://help.clatterlabs.com/billing/checkout/payment-methods): Payment methods are handled by Gumroad and shown at its checkout. Clatter Labs doesn't take payments directly. - [Who actually sells me the plan or credits?](https://help.clatterlabs.com/billing/checkout/gumroad-merchant-of-record): Gumroad is the merchant of record. It handles payment processing, payment methods, invoices and taxes. - [Why does Billing say "Waiting for Gumroad to confirm your purchase"?](https://help.clatterlabs.com/billing/checkout/waiting-for-gumroad): The Console checks every few seconds, for up to 3 minutes, until Gumroad confirms. Then the plan or credits appear. - [Why is my Account ID in the checkout link?](https://help.clatterlabs.com/billing/checkout/account-id-in-checkout-link): It tells Clatter Labs which account to give the plan or credits to. Don't edit the link or share it. - [Why is the price at checkout different from the Plans page?](https://help.clatterlabs.com/billing/checkout/price-shown-differs): Gumroad may add taxes as stated at checkout, and your bank may convert currency. Plan prices themselves are in US dollars. - [Will I be charged tax or VAT?](https://help.clatterlabs.com/billing/checkout/taxes-and-vat): Taxes are handled by Gumroad as merchant of record and shown at checkout. Prices may include or exclude tax as Gumroad states. ### Upgrades, downgrades and cancelling - [Can I pause my plan instead of cancelling?](https://help.clatterlabs.com/billing/manage-plan/pause-a-plan): There's no pause option. Cancel and buy again later; you keep the plan until the paid period ends. - [Does changing plans reset my weekly limit?](https://help.clatterlabs.com/billing/manage-plan/changing-plan-and-weekly-reset): The weekly limit follows your billing date. Exactly how a mid-week change affects it isn't published; check the meter. - [How do I cancel my paid plan?](https://help.clatterlabs.com/billing/manage-plan/cancel-your-plan): Billing › Manage or cancel opens your Gumroad subscription. Cancel there; you keep the plan until the end of the paid period. - [How do I change to a different plan?](https://help.clatterlabs.com/billing/manage-plan/change-plan): On Billing, select Change plan or Change to . The change is made on your Gumroad subscription. - [How do I downgrade to a cheaper plan?](https://help.clatterlabs.com/billing/manage-plan/downgrade-your-plan): Change to the smaller plan from Billing. Under the Terms, a downgrade takes effect at the next billing period. - [How do I get my plan back after cancelling?](https://help.clatterlabs.com/billing/manage-plan/resubscribe): If it hasn't ended, manage the subscription on Gumroad. If it has ended, buy the plan again from Billing › Plans. - [How do I go back to the Free plan?](https://help.clatterlabs.com/billing/manage-plan/switch-to-free): Cancel your paid plan. When the paid period ends, your account moves to Free automatically. - [How do I upgrade my plan?](https://help.clatterlabs.com/billing/manage-plan/upgrade-your-plan): Billing › Plans: on Free select Get ; on a paid plan select Change to , which opens your Gumroad subscription. - [I cancelled my plan by mistake. Can I undo it?](https://help.clatterlabs.com/billing/manage-plan/cancel-by-mistake): Your plan stays active until the paid period ends. Use Manage to see Gumroad's options, or buy it again after it ends. - [I changed my email. Does my subscription still work?](https://help.clatterlabs.com/billing/manage-plan/change-email-on-subscription): Your plan is tied to your Account ID, not your email. Gumroad emails go to the address used at checkout. - [I forgot to cancel and my plan renewed. Can I get the money back?](https://help.clatterlabs.com/billing/manage-plan/what-if-i-forget-to-cancel): Fees for a started period aren't refundable except where law requires or in particular cases. Cancel now to stop the next one. - [I upgraded but I'm still blocked by a limit. Why?](https://help.clatterlabs.com/billing/manage-plan/upgrade-then-limit): Make sure the upgrade shows in Billing (Refresh payment status). A team member's caps or Telegram's daily limit can still apply. - [I'm downgrading. What about my team members?](https://help.clatterlabs.com/billing/manage-plan/members-and-downgrade): Under the Terms you must reduce members, storage and usage to fit the new plan's limits. - [My granted plan is ending. How do I keep it?](https://help.clatterlabs.com/billing/manage-plan/granted-plan-ending): Buy the plan from Billing › Plans before or after the end date. Otherwise the account moves to Free. - [My paid plan ended and I didn't cancel. Why?](https://help.clatterlabs.com/billing/manage-plan/plan-ended-unexpectedly): Usually a failed renewal payment or a granted plan reaching its end date. Check Billing › History and Gumroad. - [My plan says "Payment failed". Will I lose it?](https://help.clatterlabs.com/billing/manage-plan/failed-payment-on-renewal): Update your card on Gumroad to keep the plan. Paid features may be suspended until the payment goes through. - [Should I cancel my plan before deleting my account?](https://help.clatterlabs.com/billing/manage-plan/cancel-and-delete-account): Yes. Cancel in Billing first so it doesn't renew. Consumed credits aren't refundable; ask about unused credits within 14 days. - [What do the plan statuses in Billing mean?](https://help.clatterlabs.com/billing/manage-plan/plan-statuses): Active, Cancels at period end, Cancelled, Ended, Refunded and Payment failed, explained. - [What does "Manage or cancel" do?](https://help.clatterlabs.com/billing/manage-plan/manage-or-cancel-button): It opens your subscription on Gumroad, where you can cancel, change tier or update payment details. - [What happens after I cancel my plan?](https://help.clatterlabs.com/billing/manage-plan/what-happens-after-cancel): You keep the plan until the end of the period you paid for, then the account moves to Free with no further charge. - [What happens to my Code Buckets files if I downgrade?](https://help.clatterlabs.com/billing/manage-plan/downgrade-and-storage): Files stay, but uploads fail past the new limit. Reduce storage to fit; excess not fixed within 30 days after notice may be deleted. - [When does my plan renew?](https://help.clatterlabs.com/billing/manage-plan/when-does-my-plan-renew): Plans renew automatically each month. Billing › Overview shows "Renews around "; History shows Paid through. ### Refunds - [Can I get a refund for credits I haven't used?](https://help.clatterlabs.com/billing/refunds/refund-unused-credits): Yes, purchased credits can be refunded on request within 14 days of purchase, minus anything already used. - [Can I get a refund for my plan?](https://help.clatterlabs.com/billing/refunds/refund-a-subscription): Fees for a billing period that has already started aren't refundable, except where the law requires or in a particular case. - [Can I get credits back if the model gave a wrong answer?](https://help.clatterlabs.com/billing/refunds/refund-for-bad-answer): Usage is billed for tokens processed, whatever the answer quality. Consumed credits aren't refundable; report problems to support. - [Do I get a refund if my account is suspended?](https://help.clatterlabs.com/billing/refunds/refund-after-suspension): A 24-hour abuse-policy pause doesn't touch your credits or plan. Accounts ended for breach of the Terms don't get refunds. - [Do I get compensation for an outage?](https://help.clatterlabs.com/billing/refunds/refund-during-outage): Service credits for outages apply only under a separate signed SLA. Refused or failed requests generally aren't billed. - [Do refund rules override my consumer rights?](https://help.clatterlabs.com/billing/refunds/consumer-rights): No. Nothing in the refund terms limits refund rights a consumer has under mandatory law where they live. - [How do I ask for a refund?](https://help.clatterlabs.com/billing/refunds/how-to-request-a-refund): Email support with your Account ID, the Gumroad receipt and what you want refunded. Refunds go through Gumroad. - [How do I dispute a charge or a usage amount?](https://help.clatterlabs.com/billing/refunds/dispute-a-charge): Contact support within 60 days with your Account ID and details. Clatter Labs investigates using its metering records. - [How long does a refund take and how do I see it?](https://help.clatterlabs.com/billing/refunds/refund-status): Refunds are processed by Gumroad; timing depends on Gumroad and your bank. Billing shows refunded purchases. - [I barely used my plan this month. Can I get money back?](https://help.clatterlabs.com/billing/refunds/refund-for-unused-plan-usage): No. Plan fees for a started period aren't refundable and unused usage doesn't roll over. Downgrade or cancel for next month. - [I bought credits by mistake. What can I do?](https://help.clatterlabs.com/billing/refunds/accidental-purchase): Don't use them, and email support within 14 days with the receipt. Unused purchased credits can be refunded on request. - [If my plan payment is refunded, do I keep the plan?](https://help.clatterlabs.com/billing/refunds/refund-and-plan-access): No. A refunded subscription shows Refunded and the account returns to Free. - [My child bought credits or a plan without permission. What can I do?](https://help.clatterlabs.com/billing/refunds/minor-purchase-refund): Minors may only buy through a parent or guardian. Contact support with the Account ID and receipt as soon as possible. - [Someone used my leaked API key. Can I get the credits back?](https://help.clatterlabs.com/billing/refunds/charges-from-a-leaked-key): You're responsible for usage with your keys under the Terms. Revoke the key at once and tell support quickly with details. - [What happens to my balance when a credit purchase is refunded?](https://help.clatterlabs.com/billing/refunds/refund-removes-credits): The refunded credits are removed from your balance once and a Refund row appears in Credit history. - [What if Clatter Labs discontinues a paid service I use?](https://help.clatterlabs.com/billing/refunds/refund-if-service-ends): If Clatter Labs discontinues a paid service without a reasonable equivalent, unused prepaid fees and credits are refunded. - [What is Clatter Labs' refund policy?](https://help.clatterlabs.com/billing/refunds/refund-policy): Consumed credits aren't refundable; unused purchased credits within 14 days; started subscription periods aren't, except where law requires. ### Invoices and history - [Can I download my billing history?](https://help.clatterlabs.com/billing/invoices-history/export-billing-history): The Console has no export button. Gumroad receipts are your payment records; GET /v1/account gives 30-day usage. - [Can I get an invoice with my company's details?](https://help.clatterlabs.com/billing/invoices-history/invoice-for-a-company): Invoices are issued by Gumroad as merchant of record. Use Gumroad's receipt options; purchase-order terms don't apply. - [How do I read my credit history?](https://help.clatterlabs.com/billing/invoices-history/read-credit-history): Each row is one change: free credit, purchases, refunds, adjustments, and one API usage row per day. - [My billing history is empty. Is that normal?](https://help.clatterlabs.com/billing/invoices-history/history-empty): Yes, if you've never bought anything. Once your $5 free credit is granted, it appears there as a Free credit row. - [What do the types in Credit history mean?](https://help.clatterlabs.com/billing/invoices-history/credit-history-types): Free credit, Model API trial, Credits, Top-up, Refund, API usage, Adjustment and the legacy Plan → API credits. - [What does "Paid through" mean in Billing › History?](https://help.clatterlabs.com/billing/invoices-history/subscriptions-table): The date your current paid period runs to. Your plan stays active until then. - [What is an "Adjustment" in my credit history?](https://help.clatterlabs.com/billing/invoices-history/adjustment-rows): A correction to your balance. Corrections are added as new rows instead of editing or deleting old ones. - [What records should I give my accountant?](https://help.clatterlabs.com/billing/invoices-history/history-for-accountant): Gumroad receipts for every purchase, plus Billing › History screenshots or GET /v1/account data for usage. - [What's on the Billing › History tab?](https://help.clatterlabs.com/billing/invoices-history/billing-history-tab): A Subscriptions table (plan, status, started, paid through) and a Credit history (date, type, description, amount). - [Where can I see plans I had before?](https://help.clatterlabs.com/billing/invoices-history/where-is-my-old-plan): Billing › History › Subscriptions lists past and current plans with their status. - [Where do I get a receipt or invoice?](https://help.clatterlabs.com/billing/invoices-history/get-a-receipt): Gumroad, the merchant of record, handles invoices and sends your receipt. Billing › History shows the purchase. - [Why are my payment records split between Gumroad and the Console?](https://help.clatterlabs.com/billing/invoices-history/why-two-places): Gumroad sells and issues receipts as merchant of record; the Console tracks what each purchase gave your account. - [Why is my API usage shown as one row per day?](https://help.clatterlabs.com/billing/invoices-history/usage-rows-daily): Credit history totals API spending per day. Logs and Usage show each request. ### Team billing - [Are a team member's own API keys billed to the team?](https://help.clatterlabs.com/billing/teams-billing/members-own-keys): Yes. A member's keys draw on the owner's credits, within the member's access and limits. - [Can a team member buy their own plan while on a team?](https://help.clatterlabs.com/billing/teams-billing/member-buy-own-plan): Plan buttons show "Team plan" and are disabled. Leave the team to buy for your own account. - [Can a team owner see how much each member spent?](https://help.clatterlabs.com/billing/teams-billing/team-owner-sees-member-spend): Yes. Team shows This month per member, Logs filter by member, and Usage has By team member · this month. - [Does each team member get their own Code Buckets storage?](https://help.clatterlabs.com/billing/teams-billing/team-storage): No. Members work in the owner's Code Buckets workspace and share the owner's plan storage. - [Does removing a member stop them spending our credits?](https://help.clatterlabs.com/billing/teams-billing/removing-member-stops-spend): Yes, immediately. They lose access to the plan, credits and workspace; past usage stays in Logs. - [How does billing work for a team?](https://help.clatterlabs.com/billing/teams-billing/how-team-billing-works): Members use the owner's plan, credits and Code Buckets workspace, within the access and limits the owner sets. - [If a member leaves mid-month, does their usage still count?](https://help.clatterlabs.com/billing/teams-billing/member-leaves-mid-month): Yes. Usage made while on the team stays on the owner's plan, credits and Logs. After leaving, it's on their own account. - [Our team is running low on credits. How do we top up?](https://help.clatterlabs.com/billing/teams-billing/team-credits-low): Only the owner can buy credits: Billing › Credits on the owner's account. - [Our team keeps hitting the plan limit. What should we do?](https://help.clatterlabs.com/billing/teams-billing/upgrade-for-a-team): Upgrade the owner's plan, add member quotas so one person can't use it all, and move routine work to Flash. - [Should team limits be in dollars or tokens?](https://help.clatterlabs.com/billing/teams-billing/dollars-or-tokens): Dollars track spend across models at list price; tokens track volume. Pick dollars to control cost. - [What are "Your daily team quota" and "Your monthly team limit" in Billing?](https://help.clatterlabs.com/billing/teams-billing/team-member-meters): The limits your team owner set for you, with used of total and "set by your team owner". - [What happens to members if the owner cancels the team's plan?](https://help.clatterlabs.com/billing/teams-billing/team-plan-cancelled): When the paid period ends, the team uses Free's monthly allowance and storage. Credits still pay for API calls. - [What happens to my own plan and credits when I join a team?](https://help.clatterlabs.com/billing/teams-billing/what-happens-to-my-own-plan-on-a-team): While you're on a team, your usage runs on the team's. When you leave, you go back to your own plan and credits. - [What happens to the team when the owner's credits or plan run out?](https://help.clatterlabs.com/billing/teams-billing/what-if-owner-runs-out): Everyone is affected: API calls answer 402 at zero credits and app usage waits when the shared plan limit is reached. - [Who pays when a team member uses Clatter Labs?](https://help.clatterlabs.com/billing/teams-billing/owner-pays): The team owner. Members' plan usage and API credits are charged to the owner's account. ### Promotions and free offers - [A promotion should have covered my usage but it was counted. Why?](https://help.clatterlabs.com/billing/promotions/promo-not-applied): Check the promo's plan, model, product and time window. Usage outside any of them counts normally. - [Are there discount or coupon codes?](https://help.clatterlabs.com/billing/promotions/discount-codes): Clatter Labs doesn't publish discount codes. Offers are announced on the blog and changelog. - [Can I create several accounts to get more free credit?](https://help.clatterlabs.com/billing/promotions/multiple-accounts-for-free-credit): No. Free credit is once per account, and credits obtained in breach of the Terms can be revoked. - [Do launch promotions apply to paid plans too?](https://help.clatterlabs.com/billing/promotions/promo-and-paid-plans): Only if the promotion says so. The SuperCosmos 1.1 Flash promo was Free-only; paid plans got 25% higher limits instead. - [Does Clatter Labs give out free plans or credits?](https://help.clatterlabs.com/billing/promotions/grants-and-free-offers): Every new account gets $5 of free credit once. Clatter Labs sometimes grants plans or credits; they show in Billing. - [How do Clatter Labs launch promotions work?](https://help.clatterlabs.com/billing/promotions/how-launch-promos-work): Promotions are announced on the blog or changelog with their own terms: which plans, models, products and how long. - [How do I see which requests a promotion covered?](https://help.clatterlabs.com/billing/promotions/promo-usage-in-logs): Promotion-covered requests appear in Logs at list price with Paid by: Not charged. - [The free Flash launch promo ended. Why is Line using my allowance again?](https://help.clatterlabs.com/billing/promotions/launch-promo-ended): The SuperCosmos 1.1 promo ended at 00:30 UTC on Nov 3, 2026. Since then Flash counts toward your Free allowance again. - [What rules apply to promotional or free credits?](https://help.clatterlabs.com/billing/promotions/promotional-credits): Promotional credits expire as stated when granted, are used before purchased credits, and can be revoked if obtained in breach. - [What was the SuperCosmos 1.1 launch promotion?](https://help.clatterlabs.com/billing/promotions/supercosmos-1-1-launch-promo): For 24 hours from the Nov 2, 2026 launch, Free-plan users got SuperCosmos Flash free in Line CLI and Telegram, not counting against quota. ### Billing for companies - [Are there discounts for schools, nonprofits or open-source projects?](https://help.clatterlabs.com/billing/business/nonprofit-or-education): No such discounts are published. Contact support to describe your project. - [Can a company pay for employees who use Line CLI?](https://help.clatterlabs.com/billing/business/paying-for-employees): Yes. The company owner account picks a plan and invites employees to its team with Line CLI access and limits. - [Can we get alerts when spending reaches a budget?](https://help.clatterlabs.com/billing/business/budget-alerts): There's no budget-alert setting. Use member monthly limits, low-credit Inbox messages and your own checks on GET /v1/account. - [Can we pay by purchase order or with our own contract terms?](https://help.clatterlabs.com/billing/business/purchase-orders): Purchases go through Gumroad. Terms on a purchase order or vendor form have no effect. Ask support for special arrangements. - [Can we resell Clatter Labs API access to our customers?](https://help.clatterlabs.com/billing/business/reselling-access): Not as a standalone service, proxy or gateway without a written reseller agreement. Building your own product on top is fine. - [How can a company control what each person spends?](https://help.clatterlabs.com/billing/business/control-team-spending): Use a team with per-member access and daily or monthly limits, separate keys per service, and watch Logs and Usage. - [How do we bill our own customers for usage of our app?](https://help.clatterlabs.com/billing/business/end-user-billing): Clatter Labs bills you, the key owner. Track your users on your side; Logs show usage by key, not by your end user. - [How do we plan a monthly budget for API usage?](https://help.clatterlabs.com/billing/business/budget-for-api-usage): Measure typical requests, price them, multiply by volume, add a buffer, then monitor with GET /v1/account and Usage. - [How do we split Clatter Labs costs between departments or clients?](https://help.clatterlabs.com/billing/business/cost-allocation): Give each department or client its own key (and team members their own limits), then read Logs by key and Usage by member. - [Is there a service-level agreement (SLA)?](https://help.clatterlabs.com/billing/business/sla): Uptime commitments, service credits and support times apply only under a separate signed SLA. Status shows live health. - [Is there an Enterprise plan for companies?](https://help.clatterlabs.com/billing/business/is-there-an-enterprise-plan): No Enterprise plan is sold. Companies use the largest plans, Console teams and credits, and can ask support about larger needs. - [Our team owner is leaving the company. What happens to billing?](https://help.clatterlabs.com/billing/business/move-company-to-new-owner): The plan, credits and workspace belong to the owner's account. Plan ahead, and contact support with both Account IDs. - [Should our company use one account with a team, or separate accounts?](https://help.clatterlabs.com/billing/business/separate-accounts-or-team): A team gives one bill and central control. Separate accounts give fully separate plans, credits and keys. - [We need more than Ultra or the standard limits. Who do we talk to?](https://help.clatterlabs.com/billing/business/larger-limits): Email support@clatterlabs.com with your Account ID and what you need. Nothing beyond published plans is promised. - [Where can our security team learn how billing and data are handled?](https://help.clatterlabs.com/billing/business/security-review): Payments are processed by Gumroad; account and data handling are in the Terms, Privacy Policy and the Security & privacy articles. - [Who owns credits bought for a company?](https://help.clatterlabs.com/billing/business/who-owns-purchases): Credits belong to the account that bought them. Use a company-controlled owner account so credits stay with the company. ## Console API keys, logs, the playground, teams, inbox, the models page and billing pages. ### Getting started with the Console - [Can anyone else see my Console?](https://help.clatterlabs.com/console/getting-started/who-can-see-my-console): Only you see your Console, unless you invite people onto a team. Team owners see their members' usage in Logs. - [Console glossary: what do these words mean?](https://help.clatterlabs.com/console/getting-started/console-glossary): Short definitions of Console terms: Account ID, API key, scope, rate limit, credits, plan, usage window, run, tier and more. - [Do I need a Clatter Labs account to use the Console?](https://help.clatterlabs.com/console/getting-started/do-i-need-an-account): Yes. The Console has no separate sign-up; it uses your Clatter Labs account, which you can create at accounts.clatterlabs.com. - [Do I need the Console if I only use Line CLI?](https://help.clatterlabs.com/console/getting-started/console-and-line-cli): Line CLI works with just your Clatter Labs account, but the Console is where you see its usage, change plan and read Logs. - [Does the Console cost anything to use?](https://help.clatterlabs.com/console/getting-started/is-the-console-free): Opening and browsing the Console is free on every plan. You pay only for what you use: plan usage, API calls and Code Buckets data. - [How do I sign in to the Console?](https://help.clatterlabs.com/console/getting-started/sign-in-to-the-console): Sign in to console.clatterlabs.com with your Clatter Labs account. Here's what to expect on the sign-in page. - [How should a company set up the Console?](https://help.clatterlabs.com/console/getting-started/console-for-companies): Practical setup for teams and companies: one owner account, a team, separate keys per service, budgets and monitoring. - [I'm new to coding. What is the Console, in simple words?](https://help.clatterlabs.com/console/getting-started/console-for-beginners): A plain-language explanation of the Console for beginners and younger users: what keys, credits and plans are. - [Is the Console available in other languages?](https://help.clatterlabs.com/console/getting-started/console-language): The Console is in English. SuperCosmos itself answers in the language you write in, including in the Playground. - [What is the Clatter Labs Console?](https://help.clatterlabs.com/console/getting-started/what-is-the-console): The Console is where you manage API keys, usage, logs, your plan and credits for every Clatter Labs developer product. - [What should I do first after signing in to the Console?](https://help.clatterlabs.com/console/getting-started/first-steps-in-the-console): A short checklist for new Console users: copy your Account ID, make a key, try the Playground and check your plan. - [What's on each page of the Console?](https://help.clatterlabs.com/console/getting-started/tour-of-the-console): A quick map of the Console sidebar: Home, Playground, API keys, Logs, Code Buckets, Billing, Team, Inbox, Docs and Models. - [What's the difference between the Console and Clatter Labs Accounts?](https://help.clatterlabs.com/console/getting-started/console-vs-accounts): Accounts is where you sign in and manage your profile and security. The Console is where you manage keys, usage, billing and teams. - [Which browsers and devices does the Console work on?](https://help.clatterlabs.com/console/getting-started/console-browser-support): The Console runs in any current web browser on desktop or phone, in light or dark mode. Nothing to install. - [Which Clatter Labs products can I manage in the Console?](https://help.clatterlabs.com/console/getting-started/what-products-the-console-manages): The Console covers the Agent API, Model API, Line CLI usage, Cosmos Agent on Telegram usage, Code Buckets, plans, credits and teams. ### Account ID - [Can I change my Account ID?](https://help.clatterlabs.com/console/account-id/can-i-change-my-account-id): No. Your Account ID is permanent and stays the same even if you change your name or email. - [How do I copy my Account ID?](https://help.clatterlabs.com/console/account-id/copy-account-id): Use the copy button next to your Account ID on Home, API keys or the account menu. You'll see "Account ID copied". - [How do I send my Account ID when using an OpenAI SDK with the Model API?](https://help.clatterlabs.com/console/account-id/account-id-in-openai-sdk): Add X-Clatter-Account as a default header when you create the OpenAI client, and set the Model API base URL. - [How do I store my Account ID and key as environment variables?](https://help.clatterlabs.com/console/account-id/set-account-id-environment-variable): Keep your key and Account ID in CLATTER_API_KEY and CLATTER_ACCOUNT_ID so code and curl examples work without pasting secrets. - [I have two Clatter Labs accounts. Which Account ID do I use?](https://help.clatterlabs.com/console/account-id/two-accounts-two-ids): Each account has its own Account ID, keys, plan and credits. Always send the Account ID of the account that created the key. - [The docs say my Account ID is in Console Settings, but I can't find Settings. Where is it?](https://help.clatterlabs.com/console/account-id/docs-say-settings): The Console no longer has a Settings page. Your Account ID is on Home, on API keys and in the account menu. - [What is an Account ID?](https://help.clatterlabs.com/console/account-id/what-is-an-account-id): Your Account ID is your account's permanent number, like CL-7K2M9QXA. APIs require it next to your API key. - [Where do I find my Account ID?](https://help.clatterlabs.com/console/account-id/find-your-account-id): Your Account ID (CL-…) is shown with a copy button on the Console Home page, the API keys page and in the account menu. - [Why do API requests need my Account ID as well as the key?](https://help.clatterlabs.com/console/account-id/why-account-id-header): The X-Clatter-Account header means a leaked key alone can't be used. The key and the Account ID must belong together. ### Home page - [How do I use the "Run your first agent task" card on Home?](https://help.clatterlabs.com/console/home/first-agent-task-card): Create a key from the card, then copy the code tabs to create a Cosmos Agent run, stream its events and get the result. - [The Plan card on Home says "Limit reached". What now?](https://help.clatterlabs.com/console/home/limit-reached-on-home): You've used a plan limit. App requests wait until it resets; check the reset time in Billing, or upgrade for more usage. - [Usage on the Home page isn't updating. Why?](https://help.clatterlabs.com/console/home/usage-not-updating): Live numbers only refresh while the tab is visible and connected. Check the live badge, bring the tab to front, or reload. - [What does "Tokens · 30 days" on Home count?](https://help.clatterlabs.com/console/home/tokens-30-days-card): It adds up input and output tokens from all metered requests over the last 30 days, with request and active-key counts. - [What does Home look like if I'm on someone else's team?](https://help.clatterlabs.com/console/home/home-for-team-members): Team members see the team's plan on Home, and their usage runs on the owner's plan and credits. - [What does the Console Home page show?](https://help.clatterlabs.com/console/home/what-the-home-page-shows): A guide to the Home page: Account ID, plan card, API credits, 30-day tokens, first-run code, live usage and product cards. - [What does the Console look like on a brand-new account?](https://help.clatterlabs.com/console/home/home-on-day-one): Free plan at 0%, $5 of API credits, no keys or usage yet, and a "Run your first agent task" card to get started. - [What does the Plan card on Home mean?](https://help.clatterlabs.com/console/home/plan-card-on-home): The Plan card shows your plan name, a usage bar and a percentage: this month on Free, or the window and week on paid plans. - [What is the API credits card on the Home page?](https://help.clatterlabs.com/console/home/api-credits-card-on-home): It shows your credit balance for the Model API and Agent API, marks it "Empty" at zero, and links to Add credits. - [What is the live usage strip on Home?](https://help.clatterlabs.com/console/home/live-usage-strip): The strip shows metered requests in 10-second slots over the last 10 minutes, updating about once a second while you watch. - [Why don't I see an Upgrade button on Home?](https://help.clatterlabs.com/console/home/upgrade-button-missing): Upgrade only shows when you don't have a paid plan. Subscribers and team members manage plans from Billing. ### API keys - [Can Clatter Labs support see or recover my API key?](https://help.clatterlabs.com/console/api-keys/can-support-see-my-key): No. Only a keyed hash is stored, so nobody can see or recover a key. Never send a key to anyone, including support. - [Can I undo revoking a key?](https://help.clatterlabs.com/console/api-keys/can-i-unrevoke-a-key): No. Revoking is permanent. Create a new key with the same permissions and rate limit instead. - [Can I use the same API key on several servers?](https://help.clatterlabs.com/console/api-keys/same-key-on-several-servers): Yes, it works, but they share one rate limit and you can't revoke one server alone. Separate keys are usually better. - [Can one API key work for the Agent API, the Model API and Code Buckets?](https://help.clatterlabs.com/console/api-keys/keys-work-across-products): Yes, if you give it the permissions for each. Separate keys per product are safer and make Logs easier to read. - [How can my code tell how close it is to a key's rate limit?](https://help.clatterlabs.com/console/api-keys/rate-limit-headers): Responses include X-RateLimit-Limit and X-RateLimit-Remaining; a 429 adds Retry-After with seconds to wait. - [How do I clean up old API keys?](https://help.clatterlabs.com/console/api-keys/clean-up-unused-keys): Review the keys list, check Last used and Access, and revoke keys you no longer need. Revoked keys stay listed under All. - [How do I create a key for Code Buckets?](https://help.clatterlabs.com/console/api-keys/keys-for-code-buckets): Choose the Code Buckets preset (buckets:read, buckets:write, backups:write), or customize for read-only access. - [How do I create a key for the Agent API?](https://help.clatterlabs.com/console/api-keys/keys-for-agent-api): The default Agent API preset gives runs:write and runs:read. Add account:read if your code checks the balance. - [How do I create a key for the Model API?](https://help.clatterlabs.com/console/api-keys/keys-for-model-api): Choose the Model API preset, which gives the key models:invoke. Then use it with the base URL and your Account ID. - [How do I create an API key?](https://help.clatterlabs.com/console/api-keys/create-an-api-key): In the Console go to API keys › Create API key, name it, pick permissions, a rate limit and an expiry, then copy the key once. - [How do I give a key a custom set of permissions?](https://help.clatterlabs.com/console/api-keys/custom-key-permissions): In Create API key, select Customize and tick individual permissions under Agent API, Model API and Code Buckets. - [How do I revoke an API key?](https://help.clatterlabs.com/console/api-keys/revoke-an-api-key): In API keys, select Revoke on the key and confirm. It stops working immediately everywhere and can't be undone. - [How do I rotate an API key without downtime?](https://help.clatterlabs.com/console/api-keys/rotate-an-api-key): Create a new key, deploy it, confirm traffic moved using Last used, then revoke the old key. There's no one-click rotate. - [How should I name my API keys?](https://help.clatterlabs.com/console/api-keys/name-a-key): Use names that say where and why a key is used, like "Backend (prod)" or "CI uploads". Names can be up to 64 characters. - [How should I set up keys for development, staging and production?](https://help.clatterlabs.com/console/api-keys/one-key-per-environment): Create a separate key per environment with matching permissions, shorter expiry for dev, and names that show the environment. - [I can't create another API key. Is there a limit?](https://help.clatterlabs.com/console/api-keys/too-many-api-keys): An account can have up to 25 active keys. Revoke keys you don't need to make room. The Playground's key doesn't count. - [I created a key but can't see it in the list. Where is it?](https://help.clatterlabs.com/console/api-keys/created-key-not-in-list): Check the Active/All filter, that you're in the same account, and reload. Expired and revoked keys show only under All. - [I lost my API key. Can I get it back?](https://help.clatterlabs.com/console/api-keys/lost-api-key): No. Keys are shown only once and can't be recovered. Create a new key, update your app, and revoke the old one. - [I'm sharing a script with others. How do I handle the key?](https://help.clatterlabs.com/console/api-keys/key-for-a-script-you-share): Never include your key. Have each person create their own key, or run the script on your server. - [My API key suddenly stopped working. What changed?](https://help.clatterlabs.com/console/api-keys/key-stopped-working): The key may have expired, been revoked, lost its team access, or your account may be paused. The error code tells you which. - [What do the API key permission presets include?](https://help.clatterlabs.com/console/api-keys/api-key-presets): The five presets in Create API key: Agent API, Model API, Code Buckets, Read only and Full access, and the scopes in each. - [What does "Last used" mean in the API keys list?](https://help.clatterlabs.com/console/api-keys/last-used-column): Last used shows when a key last made a request, or "Never". Use it to find unused keys and check rotations. - [What does each API key permission allow?](https://help.clatterlabs.com/console/api-keys/api-key-permissions-explained): Every Console key permission explained: runs:write, runs:read, account:read, models:invoke, buckets:read, buckets:write, backups:write. - [What happens when I revoke an API key?](https://help.clatterlabs.com/console/api-keys/what-revoking-does): Requests with a revoked key fail at once with 401 invalid_api_key, open event streams end, and the key can't be restored. - [What if I need more than 120 requests per minute?](https://help.clatterlabs.com/console/api-keys/need-more-than-120-rpm): 120 per minute is the highest per-key choice. Use separate keys per service, stream instead of polling, or ask support. - [What is an API key?](https://help.clatterlabs.com/console/api-keys/what-is-an-api-key): An API key is a secret starting with clsk_ that lets your code use the Agent API, Model API or Code Buckets on your account. - [What is the "Console Playground" key in my list?](https://help.clatterlabs.com/console/api-keys/console-playground-key): It's a key the Console manages for you so the Playground can call the APIs. It doesn't count toward your 25 keys. - [When do API keys expire?](https://help.clatterlabs.com/console/api-keys/key-expiry-options): You choose when you create the key: 30 days, 90 days (default), 1 year or Never. Expired keys stop working. - [Which key should a monitoring dashboard use?](https://help.clatterlabs.com/console/api-keys/key-permissions-for-dashboards): A Read only key (runs:read, account:read, buckets:read) can show runs, balance and storage without being able to spend. - [Which rate limit should I pick for an API key?](https://help.clatterlabs.com/console/api-keys/choose-a-rate-limit): Keys allow 10, 30, 60 or 120 requests per minute. 30 is the default; pick higher for busy services, lower for small scripts. - [Why do Clatter Labs keys start with clsk_?](https://help.clatterlabs.com/console/api-keys/key-prefix): clsk_ marks a Clatter Labs secret key, so you and secret scanners can recognise one and keep it out of code and logs. - [Why does the keys list only show part of my key?](https://help.clatterlabs.com/console/api-keys/key-hint-in-list): The list shows a short hint so you can tell keys apart. The full secret is never stored or shown after creation. - [Why is my API key shown only once?](https://help.clatterlabs.com/console/api-keys/key-shown-only-once): Clatter Labs stores only a keyed hash of your key, so the full key can't be displayed again. Copy it when it's created. ### Keeping keys safe - [Can I call the API straight from my website's JavaScript?](https://help.clatterlabs.com/console/key-security/never-put-keys-in-frontend): Technically CORS allows it, but never ship a key in front-end code. Call Clatter Labs from your server instead. - [Can I put an API key in my mobile or desktop app?](https://help.clatterlabs.com/console/key-security/key-in-a-mobile-app): No. Keys in apps you distribute can be extracted. Route requests through your own server, which holds the key. - [Can I share my API key with a teammate?](https://help.clatterlabs.com/console/key-security/share-key-with-teammate): Better not. Invite them to your team instead, so they use their own account and keys on your plan and credits. - [How do I keep my API keys secret?](https://help.clatterlabs.com/console/key-security/keep-api-keys-secret): Keep keys on servers, never in front-end code, apps, public repos or screenshots. Use secret stores and minimal permissions. - [How do I stop my API key from appearing in my app's logs?](https://help.clatterlabs.com/console/key-security/keys-in-application-logs): Never log full request headers. Redact Authorization and anything starting with clsk_, and log only error codes and request ids. - [How do I use an API key safely in CI/CD?](https://help.clatterlabs.com/console/key-security/keys-in-ci): Store the key in your CI system's secret settings, give it minimal permissions and a dedicated name, and never echo it. - [How often should a company rotate API keys?](https://help.clatterlabs.com/console/key-security/rotation-schedule): Clatter Labs doesn't force a schedule. Use key expiry (30 days to 1 year) and rotate when people leave or a leak is suspected. - [I accidentally committed an API key to Git. What now?](https://help.clatterlabs.com/console/key-security/keys-in-git): Revoke the key first, then remove it from the repository and its history. Deleting the file alone isn't enough. - [Is it safe to paste my API key into an AI chat or coding assistant?](https://help.clatterlabs.com/console/key-security/keys-and-ai-assistants): No. Never paste keys into chats, prompts or tickets. Use environment variables so tools can use a key without seeing it. - [My app lets other people use the API through my key. What am I responsible for?](https://help.clatterlabs.com/console/key-security/end-users-and-your-keys): Your key acts for your account: you pay for your end users' usage and their text counts against you under the abuse policy. - [What permissions should a key have?](https://help.clatterlabs.com/console/key-security/least-privilege-keys): Only the ones it needs. A dashboard needs runs:read and account:read; a chat app needs only models:invoke. - [What should I do if my API key leaked?](https://help.clatterlabs.com/console/key-security/what-to-do-if-a-key-leaks): Revoke the key immediately, create a replacement, check Logs and your credits for unexpected use, then find the leak. - [Where should I store my API keys?](https://help.clatterlabs.com/console/key-security/where-to-store-api-keys): Use a secret manager, your hosting platform's secret settings or environment variables. Never hard-code keys. - [Why should each service have its own API key?](https://help.clatterlabs.com/console/key-security/one-key-per-integration): Separate keys keep Logs readable, let you revoke one service without breaking others, and limit damage if one leaks. ### Logs - [Are failed API requests shown or charged in Logs?](https://help.clatterlabs.com/console/logs/failed-requests-in-logs): Requests refused before running (bad key, no credits, rate limit) aren't metered. Partly finished work is billed for what it used. - [How do I filter Logs by product or team member?](https://help.clatterlabs.com/console/logs/filter-logs): Use the product filter (All products, Line CLI, Cosmos Agent, Telegram, Model API, Agent API, Code Buckets) and the member filter. - [How do I find out which requests a specific API key made?](https://help.clatterlabs.com/console/logs/find-requests-by-key): Logs has a Key column for API requests. Filter to the product, then look for the key's name to see its calls. - [How do I read a row in Logs?](https://help.clatterlabs.com/console/logs/read-a-log-row): What each Logs column means: Time, Product, Model, Tokens in / out, Cost, Key, Member and Paid by. - [How do I see what each team member used?](https://help.clatterlabs.com/console/logs/team-usage-in-logs): Team members' requests show their name in Logs. Filter by member, or use Usage › By team member for this month. - [How far back do Logs go?](https://help.clatterlabs.com/console/logs/logs-retention): Use Load older to page back through your history. Exact retention periods are described in the Privacy Policy. - [What do Code Buckets rows in Logs mean?](https://help.clatterlabs.com/console/logs/code-buckets-rows): They show Code Buckets usage in Code Buckets tokens: 1 per request plus 1 per MiB uploaded or downloaded. - [What does the "Paid by" column in Logs mean?](https://help.clatterlabs.com/console/logs/paid-by-column): Paid by shows whether a request was covered by your plan, paid from credits, from the old Model API trial, by a team, or not charged. - [What does the Logs page show?](https://help.clatterlabs.com/console/logs/what-logs-show): Logs lists every metered request across Clatter Labs products, plus the Agent API runs your keys started. - [Where can I see my Agent API runs in the Console?](https://help.clatterlabs.com/console/logs/agent-api-runs-view): Logs › Agent API runs lists runs your keys started, with Run ID, title, status, started and updated times. - [Why does Logs show a cost for requests I wasn't charged for?](https://help.clatterlabs.com/console/logs/cost-shows-but-not-charged): Cost is the list-price value. Plan-covered, promotional and team-account requests are recorded at list price but not charged. - [Why does one Line CLI task create many rows in Logs?](https://help.clatterlabs.com/console/logs/many-rows-for-one-task): Each model call is metered separately. An agent task makes many calls: planning, each tool step and sub-agents. - [Why is my Logs page empty?](https://help.clatterlabs.com/console/logs/logs-empty): Logs shows only metered requests. A new account, a wrong filter or using a different account can all make it look empty. ### Usage page - [Can I export my usage from the Console?](https://help.clatterlabs.com/console/usage/download-usage-data): There's no export button. Use GET /v1/account for 30-day totals, or read Logs. Ask support for older records. - [What are "Cloud time" and "Tool actions" on the Usage page?](https://help.clatterlabs.com/console/usage/cloud-time-and-tool-actions): Agent API resources: minutes of cloud computer and browser use, and the number of edits, commands and tool calls. - [What does "By SuperCosmos tier" on the Usage page tell me?](https://help.clatterlabs.com/console/usage/usage-by-tier): It splits calls and tokens by Flash, Max and Heavy, with each tier's price per 1M tokens and the token cost. - [What does the Usage page show?](https://help.clatterlabs.com/console/usage/what-the-usage-page-shows): Billing › Usage shows live activity today, spend and tokens per day, and breakdowns by product, SuperCosmos tier and team member. - [What is the "Right now" card on the Usage page?](https://help.clatterlabs.com/console/usage/right-now-card): A live view of today: requests, tokens and API credits used, with a feed of the latest metered calls. - [Why does Usage show both "list price" and "charged"?](https://help.clatterlabs.com/console/usage/list-price-vs-charged): List price is what usage is worth at model rates. Charged is what came out of your credits; plan-covered usage is charged $0. - [Why doesn't my latest request show up in Usage yet?](https://help.clatterlabs.com/console/usage/why-usage-looks-delayed): Usage normally appears within seconds. Delays can come from a background tab, a dropped connection or brief metering lag. ### Playground - [Can I upload images in the Playground?](https://help.clatterlabs.com/console/playground/playground-images): No. SuperCosmos reads text only, in the Playground and in the Model API. Paste text or code instead. - [Can my team members use the Playground?](https://help.clatterlabs.com/console/playground/playground-for-teams): Yes, if the owner gave them Model API & Agent API access or Everything. Their Playground use is paid from the team's credits. - [Does the abuse policy apply in the Playground?](https://help.clatterlabs.com/console/playground/abuse-policy-in-playground): Yes. Insulting or cursing at the assistant earns a warning, then a 24-hour pause of your account on every product. - [Does the Playground save my chats?](https://help.clatterlabs.com/console/playground/playground-history): Playground chats are tied to your open page and aren't a saved chat history. Copy anything you want to keep. - [How can a beginner safely try the Playground?](https://help.clatterlabs.com/console/playground/playground-for-kids): Use Flash, ask short questions, watch the cost under each answer and stay polite: the abuse policy applies. - [How do I chat with SuperCosmos in the Playground?](https://help.clatterlabs.com/console/playground/chat-mode): Open Playground › Chat, pick Flash, Max or Heavy, type a message and send. Optional system prompt, temperature and max tokens. - [How do I run Cosmos Agent from the Playground?](https://help.clatterlabs.com/console/playground/agent-mode): Open Playground › Agent, describe a task, pick a tier (or auto) and start. Watch steps live and cancel any time. - [How do I stop an agent run in the Playground?](https://help.clatterlabs.com/console/playground/cancel-a-playground-run): Select Cancel while the run is going. You pay for what it used up to that point. - [How do I turn a Playground chat into code?](https://help.clatterlabs.com/console/playground/view-code-from-playground): Select View code to get the same request in Python or JavaScript (OpenAI SDK) or cURL, ready for the Model API. - [How do I write a good system prompt in the Playground?](https://help.clatterlabs.com/console/playground/system-prompt-tips): Say who the assistant is, what to do, the format you want and what to avoid. Keep it short and test with a few messages. - [How is the Playground billed?](https://help.clatterlabs.com/console/playground/how-the-playground-is-billed): Exactly like API usage: from your API credits, at the model rates. Agent runs also pay for computer time and actions. - [I left the Playground page and my reply was cut off. Can I get it back?](https://help.clatterlabs.com/console/playground/left-page-reply-cut): A chat reply that's streaming stops when you leave the page. Agent runs keep going on Cosmos and you can reconnect. - [Is the Playground free?](https://help.clatterlabs.com/console/playground/does-the-playground-cost-money): No, it uses your API credits. Short chats cost very little, and new accounts get $5 of free credit to try it. - [The Playground lost the live steps of my agent run. Is the run gone?](https://help.clatterlabs.com/console/playground/reconnect-to-agent-run): No. The run keeps going on Cosmos. Select Retry to reconnect to its live steps, or open it from Logs. - [The Playground says "Couldn't start the run". What can I do?](https://help.clatterlabs.com/console/playground/couldnt-start-the-run): Check your network, credits and whether 5 runs are already in progress. Account setup or suspension errors explain themselves. - [The Playground says "Slow down a little". Why?](https://help.clatterlabs.com/console/playground/playground-slow-down): You sent requests faster than the Playground's key allows. Wait a few seconds and try again. - [The Playground says "The model returned an empty reply". Why?](https://help.clatterlabs.com/console/playground/empty-reply-in-playground): Sometimes a model finishes thinking without writing an answer. Resend, rephrase, raise Max tokens or try another tier. - [The Playground says "The model stream failed" or "The connection dropped". What happened?](https://help.clatterlabs.com/console/playground/model-stream-failed): The streamed answer was interrupted by the network or a busy model. Resend; check your connection and the status page. - [The Playground says "You're out of credits". What do I do?](https://help.clatterlabs.com/console/playground/playground-out-of-credits): Playground use is paid from API credits. Add credits in Billing › Credits, then try again. Your plan doesn't cover it. - [What are the example prompts in the Playground?](https://help.clatterlabs.com/console/playground/playground-examples): Chat examples like Explain a concept or Write a SQL query, and agent examples like Write and run a script or Research on the web. - [What can Cosmos Agent do in the Playground?](https://help.clatterlabs.com/console/playground/what-can-the-agent-do): Write and run code, use a terminal and files, browse the web, search, keep files, deploy and use sub-agents on its cloud computer. - [What do the numbers under a Playground answer mean?](https://help.clatterlabs.com/console/playground/playground-readout): Tokens in and out, time to first token, total latency, speed in tokens per second, and the cost of that answer. - [What do the Playground agent run messages mean?](https://help.clatterlabs.com/console/playground/agent-run-statuses): Waiting for Cosmos's cloud computer, Getting the cloud computer ready, Planning the next step, Done, Didn't start and more. - [What do the Playground chat settings do?](https://help.clatterlabs.com/console/playground/playground-settings): System prompt sets the assistant's role; temperature controls randomness; max tokens caps the answer length. - [What is the Console Playground?](https://help.clatterlabs.com/console/playground/what-is-the-playground): The Playground lets you chat with SuperCosmos or give Cosmos Agent a task in your browser, billed from credits like API use. - [What's the difference between the Playground and calling the API myself?](https://help.clatterlabs.com/console/playground/playground-vs-api): Same models, same prices. The Playground is for trying things in a browser; the API is for your own apps and automation. - [Which SuperCosmos model should I pick in the Playground?](https://help.clatterlabs.com/console/playground/choose-a-model-in-playground): Flash for quick answers, Max for planning and building, Heavy for the hardest problems. Start with Flash and move up. - [Why does my Playground answer end with "Cut off at the max tokens limit"?](https://help.clatterlabs.com/console/playground/cut-off-at-max-tokens): The answer reached the Max tokens setting. Raise Max tokens, ask for a shorter answer, or continue in a follow-up message. ### Models page - [How big is SuperCosmos's context window?](https://help.clatterlabs.com/console/models-page/context-window): 1M tokens (1,048,576) for every effort. Input above 262K tokens bills at 1.5×. - [What does the Agent API card on the Models page say?](https://help.clatterlabs.com/console/models-page/agent-api-card): Runs pick a tier, take up to about 150 steps, work on a cloud computer, and bill credits for tokens and cloud resources. - [What does the Models page in the Console show?](https://help.clatterlabs.com/console/models-page/what-the-models-page-shows): SuperCosmos tiers with model ids and prices, a Model API card with code, an Agent API card and the agent's cloud prices. - [What model ids can I use?](https://help.clatterlabs.com/console/models-page/model-ids-list): supercosmos-flash, supercosmos-max, supercosmos-heavy, or supercosmos with an effort. Line Code ids are retired. - [Where did Line Code go on the Models page?](https://help.clatterlabs.com/console/models-page/line-code-on-models-page): Line Code was retired on Nov 1, 2026. Its ids answer 410 model_retired and aren't billed. Use SuperCosmos instead. - [Where do I get ready-made Model API code?](https://help.clatterlabs.com/console/models-page/model-api-code-snippets): Console › Models has Python, JavaScript and cURL examples with the base URL and headers; the Playground's View code does too. - [Why does my Models page say "Team account: unlimited"?](https://help.clatterlabs.com/console/models-page/models-page-team-unlimited): Clatter Labs' own team accounts aren't charged. Usage is still recorded at list price. Normal accounts see their credits. ### Team - [Can a member's limits be higher than the plan's?](https://help.clatterlabs.com/console/team/team-limits-vs-plan-limits): No. Member quotas work inside the owner's plan limits and credits. They can only restrict, never extend. - [Can a teacher use a team for a class or club?](https://help.clatterlabs.com/console/team/team-for-a-class): Yes. The teacher owns the team, invites students, and limits each to the products and daily amounts that make sense. - [Can a team owner leave their own team?](https://help.clatterlabs.com/console/team/remove-yourself-as-owner): The owner can't leave like a member; the team belongs to the owner's account. Remove members to dissolve it. - [Can I be on more than one team?](https://help.clatterlabs.com/console/team/one-team-at-a-time): No. You can be on one team at a time. To join another team, you first leave yours or remove your own team's members. - [Can I transfer ownership of my team?](https://help.clatterlabs.com/console/team/transfer-team-ownership): There's no ownership transfer in the Console. The team belongs to the owner account; contact support for special cases. - [Can team members see or use the owner's API keys?](https://help.clatterlabs.com/console/team/can-members-see-owner-keys): No. Members make their own keys; owners' keys stay private. Members' own keys run on the owner's credits. - [How can an agency use teams for client work?](https://help.clatterlabs.com/console/team/team-for-an-agency): Run the team from the agency account, give staff limited access, and use one key per client to split costs in Logs. - [How do I accept a team invite?](https://help.clatterlabs.com/console/team/accept-a-team-invite): Sign in to the Console with the account the invite was sent to, open Inbox (or Team) and select Accept. - [How do I change a team member's access or limits?](https://help.clatterlabs.com/console/team/edit-member-access): On Team, select Edit next to the member, change access or limits and save. The change applies immediately. - [How do I invite someone to my team?](https://help.clatterlabs.com/console/team/invite-a-team-member): Team › Invite member: enter their email, choose access and limits, and send. They accept from their Console Inbox within 7 days. - [How do I leave a team?](https://help.clatterlabs.com/console/team/leave-a-team): Open Team, select Leave team and confirm. You go back to your own plan and credits right away. - [How do I remove someone from my team?](https://help.clatterlabs.com/console/team/remove-a-team-member): On Team, select Remove next to the member and confirm. They lose access to your plan, credits and workspace immediately. - [How do I resend or cancel a team invite?](https://help.clatterlabs.com/console/team/resend-or-withdraw-an-invite): In Team › Invites, select Resend to refresh a pending invite's 7-day expiry, or Revoke to withdraw it. - [How do I set a daily quota or monthly limit for a team member?](https://help.clatterlabs.com/console/team/set-member-limits): When inviting or editing a member, enter a Daily quota and/or Monthly limit in Dollars or Tokens. Empty means no limit. - [How many people can be on a team?](https://help.clatterlabs.com/console/team/team-seats): The Console doesn't publish a fixed number of team seats. Contact support if you plan a large team. - [I sent a team invite to the wrong email. What do I do?](https://help.clatterlabs.com/console/team/invite-wrong-email): Revoke the pending invite in Team › Invites, then send a new one to the right address. - [My invite says declined. Can I invite them again?](https://help.clatterlabs.com/console/team/invite-declined): Yes. Send a new invite with Invite member once they're ready to join. - [My teammate can't see my team invite. Why?](https://help.clatterlabs.com/console/team/invite-not-arriving): The invite is in the Console Inbox, not email, and only for the account with that verified email. Check address and expiry. - [What access can I give a team member?](https://help.clatterlabs.com/console/team/member-access-options): Everything, Model API & Agent API, Line CLI, Cosmos Agent (incl. Telegram) and Code Buckets. Changes apply right away. - [What can team members see about the team?](https://help.clatterlabs.com/console/team/what-team-members-can-see): Members see the team's plan, their own access, quotas and usage. Owners see everyone's usage per person. - [What changes when I join someone's team?](https://help.clatterlabs.com/console/team/join-a-team): Your usage, including your own API keys, runs on the owner's plan and credits, within the access and limits they set. - [What happens to a removed member's work and usage?](https://help.clatterlabs.com/console/team/what-happens-to-member-data): Their past usage stays in the owner's Logs. Their personal account stays active. Files in the team workspace stay with the owner. - [What is a team in the Console?](https://help.clatterlabs.com/console/team/what-is-a-console-team): A team lets people use one owner's plan, credits and Code Buckets workspace, each with their own account, access and limits. - [What is the Activity list on the Team page?](https://help.clatterlabs.com/console/team/team-activity-log): An audit list of team changes: invites, joins, leaves, removals and access updates, with who did what. - [What's the difference between a team owner and a member?](https://help.clatterlabs.com/console/team/owner-vs-member): The owner pays (plan, credits), invites people and sets access and limits. Members use what the owner allows. ### Inbox - [Does the Console email me about Inbox messages?](https://help.clatterlabs.com/console/inbox/inbox-email-notifications): Inbox messages live in the Console. Gumroad emails purchase receipts. For service incidents, subscribe on the status page. - [How do I mark Inbox messages as read?](https://help.clatterlabs.com/console/inbox/mark-messages-read): Open the Inbox and select Mark all as read. The bell count and sidebar badge clear. - [I got a "usage limit reached" message in my Inbox. What does it mean?](https://help.clatterlabs.com/console/inbox/limit-message): One of your plan's limits was reached. The message and Billing show which one and when it resets. - [I got a low-credits message in my Inbox. What should I do?](https://help.clatterlabs.com/console/inbox/low-credit-message): Your API credit balance is getting low. Add credits in Billing › Credits before your API calls start answering 402. - [My Inbox says "No messages yet". Is something wrong?](https://help.clatterlabs.com/console/inbox/inbox-empty): No. The Inbox only fills when something happens on your account, like a purchase, a limit or an invite. - [What is the Console Inbox?](https://help.clatterlabs.com/console/inbox/what-is-the-inbox): The Inbox collects plan and credit updates, usage-limit messages and team invites. The bell shows your unread count. - [What kinds of messages appear in the Inbox?](https://help.clatterlabs.com/console/inbox/messages-you-can-get): Plan changes, credit top-ups, usage limit reached and reset, low credits, team quota messages and team invites. ### Code Buckets in the Console - [Does browsing Code Buckets in the Console use tokens?](https://help.clatterlabs.com/console/code-buckets-pages/does-browsing-code-buckets-cost-tokens): Browsing is free. Data you upload or download in the Console counts 1 Code Buckets token per MiB. - [How do I back up and restore a bucket in the Console?](https://help.clatterlabs.com/console/code-buckets-pages/back-up-a-bucket-in-the-console): Bucket › Backups › Back up now creates a snapshot; Restore brings the code back as a new change. - [How do I create a bucket in the Console?](https://help.clatterlabs.com/console/code-buckets-pages/create-a-bucket-in-the-console): Open a project, select New bucket, enter a name and optional description, and create. Buckets start private. - [How do I create a Code Buckets project in the Console?](https://help.clatterlabs.com/console/code-buckets-pages/create-a-project-in-the-console): Code Buckets › New project, type a name and create. You can add buckets right after. - [How do I delete a bucket in the Console?](https://help.clatterlabs.com/console/code-buckets-pages/delete-a-bucket-in-the-console): Bucket Settings › Danger zone › Delete bucket, or delete from the bucket card. Its files are gone and stop counting. - [How do I delete a Code Buckets project?](https://help.clatterlabs.com/console/code-buckets-pages/delete-a-project-in-the-console): In the project, select Delete project and type its name to confirm. All its buckets are deleted first. This can't be undone. - [How do I use Code Buckets in the Console?](https://help.clatterlabs.com/console/code-buckets-pages/code-buckets-in-the-console): Code Buckets in the Console: projects hold buckets, buckets hold code zips and assets, with preview, events and backups. - [My upload in the Console stopped. How do I finish it?](https://help.clatterlabs.com/console/code-buckets-pages/resume-an-upload): Select the same file again ("Pick the same file to finish this upload") to resume, or Discard to throw it away. - [What does the Encryption section of a bucket's settings mean?](https://help.clatterlabs.com/console/code-buckets-pages/bucket-encryption-setting): Every part of every file is encrypted with the bucket's own data key, wrapped by a Clatter Labs master key on our servers. - [What does turning off Code preview do?](https://help.clatterlabs.com/console/code-buckets-pages/code-preview-setting): With preview off, a bucket's code is kept only in encrypted archives and isn't browsable in the Files tab. - [Where do I see how much Code Buckets storage I've used?](https://help.clatterlabs.com/console/code-buckets-pages/storage-meter-in-billing): Billing › Overview shows a Code Buckets storage meter: used of your plan's total, with your plan name. ### Look, menus and devices - [Can I open Console pages in new tabs?](https://help.clatterlabs.com/console/interface/keyboard-and-new-tabs): Yes. Ctrl/Cmd-click or middle-click sidebar items. Each page has its own address, like /api-keys or /billing/credits. - [How do I sign out of the Console?](https://help.clatterlabs.com/console/interface/sign-out-of-the-console): Open the account menu (your avatar) and select Sign out. - [How do I switch the Console between light and dark mode?](https://help.clatterlabs.com/console/interface/light-and-dark-mode): Use the sun/moon toggle in the top bar. By default the Console follows your device; your choice is saved in that browser. - [How do I use the Console on my phone?](https://help.clatterlabs.com/console/interface/use-the-console-on-a-phone): Open console.clatterlabs.com in your phone's browser. Tap the menu button for navigation; tables become cards. - [How is the Console sidebar organised?](https://help.clatterlabs.com/console/interface/console-sidebar-explained): Top: Home, Playground, API keys, Logs, Code Buckets. Account: Billing, Team, Inbox, Manage account. Developers: Docs. Then Models. - [What does "Manage account" in the Console do?](https://help.clatterlabs.com/console/interface/manage-account-link): It opens Clatter Labs Accounts in a new tab, where you change your profile, password, two-factor and sessions. - [What is the bar at the top of the Console saying SuperCosmos 1.1 is available?](https://help.clatterlabs.com/console/interface/announcement-bar): An announcement bar for the SuperCosmos 1.1 launch. Read the docs, or select × to hide it; it stops appearing after Nov 12, 2026. - [What's in the Console account menu?](https://help.clatterlabs.com/console/interface/account-menu): Select your avatar for your Account ID with copy, your plan, Manage account, Status, Support, Terms and privacy, and Sign out. - [Where are the Console settings?](https://help.clatterlabs.com/console/interface/no-settings-page): There's no Settings page. Theme is the top-bar toggle, Account ID is in the account menu, profile and security are in Manage account. - [Why does the Console switch back to light or dark on another device?](https://help.clatterlabs.com/console/interface/theme-keeps-changing): The theme choice is saved per browser. On a new browser it follows the device setting until you toggle it there. ### Troubleshooting errors - [How do I fix 400 invalid_json or invalid_request on the Model API?](https://help.clatterlabs.com/console/errors/invalid-json): The body isn't valid JSON or isn't a valid chat completion. Check quoting, Content-Type and the messages array. - [How do I fix 400 unsupported_content or unsupported_parameter?](https://help.clatterlabs.com/console/errors/unsupported-content): The Model API is text-only and doesn't support n > 1 or logprobs. Remove image parts and unsupported fields. - [How do I fix 401 account_mismatch?](https://help.clatterlabs.com/console/errors/account-mismatch): The Account ID you sent doesn't own the key. Send the Account ID of the account that created the key. - [How do I fix 401 expired_api_key?](https://help.clatterlabs.com/console/errors/expired-api-key): The key reached the expiry date chosen when it was created. Create a new key and replace it. - [How do I fix 401 invalid_api_key?](https://help.clatterlabs.com/console/errors/invalid-api-key): The key is wrong, revoked or cut off. Check the full clsk_ key, that it's Active in the Console, and the Bearer format. - [How do I fix 401 missing_account_id?](https://help.clatterlabs.com/console/errors/missing-account-id): Your request has no X-Clatter-Account header. Add it with your CL- Account ID next to the API key. - [How do I fix 403 insufficient_scope?](https://help.clatterlabs.com/console/errors/insufficient-scope): The key lacks the permission this endpoint needs. Create a key with that permission, such as models:invoke or runs:write. - [How do I fix 403 team_scope_denied?](https://help.clatterlabs.com/console/errors/team-scope-denied): You're on a team and the owner didn't give you access to this product. Ask the owner to add it on the Team page. - [How do I fix 404 model_not_found on the Model API?](https://help.clatterlabs.com/console/errors/model-not-found): The model id isn't one Clatter Labs serves. Use supercosmos-flash, supercosmos-max, supercosmos-heavy or supercosmos with an effort. - [How do I fix 410 model_retired?](https://help.clatterlabs.com/console/errors/model-retired): You called a retired model id, such as a Line Code id. Switch to supercosmos-flash, -max or -heavy. Not billed. - [How do I fix 413 too_large or request_too_large?](https://help.clatterlabs.com/console/errors/request-too-large): The request is over the size limits: Agent API input 20,000 characters / 64 KB body; Model API 3 MB or 800 messages. - [How do I fix 429 rate_limited?](https://help.clatterlabs.com/console/errors/rate-limited): The key made more requests per minute than its limit. Wait the Retry-After seconds, back off, or use a higher-limit key. - [List of Clatter Labs API error codes](https://help.clatterlabs.com/console/errors/error-codes-index): Every error code by HTTP status for the Agent API and Model API, with a link to what to do. - [My Model API stream ended with an error event. What happened?](https://help.clatterlabs.com/console/errors/stream-error-midway): A stream that fails midway sends data: {"error": …} then data: [DONE]. Retry the call; check status if it repeats. - [What do Clatter Labs API errors look like?](https://help.clatterlabs.com/console/errors/error-format): Errors are JSON with a stable code and a message. The Model API uses the OpenAI error shape and returns X-Request-Id. - [What does 403 account_suspended mean, and how long does it last?](https://help.clatterlabs.com/console/errors/account-suspended): Your account is paused for 24 hours under the abuse policy. Wait until resets_at, or appeal through Support. - [What is the x-clatter-notice: abuse_warning header?](https://help.clatterlabs.com/console/errors/abuse-warning-header): A first strike under the abuse policy. The request still succeeds, with x-clatter-notice and the warning text. - [What should I do about model_overloaded, model_unavailable or model_timeout?](https://help.clatterlabs.com/console/errors/model-overloaded): The model is at capacity or briefly unavailable. Retry with backoff, honouring Retry-After when it's sent. - [What should I include when I contact support about an API error?](https://help.clatterlabs.com/console/errors/what-to-send-support-about-an-error): Your Account ID, the error code and message, the time with time zone, the endpoint, the X-Request-Id or run id. Never the key. ### Console problems - [Can I turn off the animations on the Console sign-in page?](https://help.clatterlabs.com/console/troubleshooting/reduced-motion): The sign-in page respects your device's "reduce motion" setting. - [How do I check whether Clatter Labs is having an outage?](https://help.clatterlabs.com/console/troubleshooting/check-service-status): Open status.clatterlabs.com (also in the account menu). Subscribe for email alerts or use the RSS feed. - [How do I delete my Console data or close my account?](https://help.clatterlabs.com/console/troubleshooting/delete-console-data): Revoke keys and delete Code Buckets yourself. Account deletion and permanent data deletion are handled via Accounts and infrastructure@. - [How do I get to the Console from the Clatter Labs website?](https://help.clatterlabs.com/console/troubleshooting/find-the-console): Go to console.clatterlabs.com directly, or use the Console link in the footer of www.clatterlabs.com or the docs. - [I can't sign in to the Console. What should I try?](https://help.clatterlabs.com/console/troubleshooting/cant-sign-in-to-the-console): Read the message shown, try again from the Console page, check you're using the right account, and allow cookies. - [I see usage in Logs that I don't recognise. What should I do?](https://help.clatterlabs.com/console/troubleshooting/unexpected-usage): Find the key and member in Logs, revoke the key if it isn't yours, check team members, and contact support with details. - [I'm signed in to the wrong account in the Console. How do I switch?](https://help.clatterlabs.com/console/troubleshooting/wrong-account-signed-in): Sign out from the account menu, then sign in again and choose the other account at Clatter Labs Accounts. - [I'm under 18. Can I use the Console?](https://help.clatterlabs.com/console/troubleshooting/minor-using-console): Yes, from 13 up, with a parent or guardian's consent where the law requires it. Purchases must go through a parent or guardian. - [My credit balance in the Console looks wrong. What should I check?](https://help.clatterlabs.com/console/troubleshooting/balance-looks-wrong): Check Billing › History for recent usage, grants, purchases and refunds, refresh payment status, then contact support. - [My key works with curl but not in my app. Why?](https://help.clatterlabs.com/console/troubleshooting/key-works-in-curl-not-in-app): Usually the app sends no X-Clatter-Account header, reads an empty environment variable, or adds hidden spaces to the key. - [My name or picture in the Console is wrong or old. How do I fix it?](https://help.clatterlabs.com/console/troubleshooting/name-or-picture-wrong): The Console shows your Clatter Labs account profile. Change it in Manage account; open Console tabs pick up the change. - [The announcement bar keeps coming back. How do I hide it for good?](https://help.clatterlabs.com/console/troubleshooting/announcement-keeps-showing): Dismissing is remembered per browser. Another browser, a private window or cleared site data shows it again until Nov 12, 2026. - [The Console doesn't work on my company network. What can I do?](https://help.clatterlabs.com/console/troubleshooting/console-blocked-at-work): Ask IT to allow clatterlabs.com addresses (Console, Accounts, APIs, status) and Gumroad checkout if you buy there. - [The Console feels slow. How can I speed it up?](https://help.clatterlabs.com/console/troubleshooting/console-slow): Close unused Console tabs, keep the browser up to date, and check your network. Large Code Buckets folders load in pages. - [The Console misbehaves on my VPN. What can I do?](https://help.clatterlabs.com/console/troubleshooting/console-and-vpn): Some VPNs or networks block sign-in redirects or live updates. Try without the VPN or another network. - [The Console says "Your account is on the waitlist for the Console". What does that mean?](https://help.clatterlabs.com/console/troubleshooting/console-waitlist-message): Your account can't open the Console yet. Contact support with your Account ID or email. - [The Console won't load or says "Console unavailable". What can I do?](https://help.clatterlabs.com/console/troubleshooting/console-wont-load): Select Retry, reload, check your network and the status page, try a private window, and disable blocking extensions. - [The copy button in the Console doesn't work. What can I do?](https://help.clatterlabs.com/console/troubleshooting/copy-button-doesnt-work): Your browser blocked clipboard access. Allow it, or select the text and copy manually. For a new key, don't close the dialog first. - [The live badge on Usage says it isn't connected. What does that mean?](https://help.clatterlabs.com/console/troubleshooting/live-badge-offline): The Console can't fetch live usage right now. Totals still load; check your network, bring the tab forward, or reload. - [What happens if I revoke all my API keys?](https://help.clatterlabs.com/console/troubleshooting/what-if-i-revoke-every-key): Every app using a key stops at once with 401 invalid_api_key. Your plan, credits and data are untouched; create new keys any time. - [What happens to my apps if the Console is down?](https://help.clatterlabs.com/console/troubleshooting/what-if-console-is-down): Your API keys and running work don't depend on having the Console open. Status shows each service separately. - [What time zone does the Console use?](https://help.clatterlabs.com/console/troubleshooting/time-zones-in-console): Times show in your browser's local time. Some resets follow UTC, such as the Free month (1st of the month, UTC). - [Why does the Console say "This page isn't here"?](https://help.clatterlabs.com/console/troubleshooting/page-not-found): The address doesn't match a Console page, often an old bookmark. Select Back to Home and use the sidebar. ## SuperCosmos models SuperCosmos 1.1 Flash, Max and Heavy: context, pricing, behaviour, previous versions and Line Code (retired). ### Getting started with SuperCosmos - [Can I download SuperCosmos or run it myself?](https://help.clatterlabs.com/supercosmos/getting-started/is-supercosmos-open-source): No download is offered. SuperCosmos is available through Clatter Labs products and APIs. - [Can SuperCosmos search the internet?](https://help.clatterlabs.com/supercosmos/getting-started/does-supercosmos-browse-the-web): Not by itself. It can use web tools when a product provides them (Line CLI has web search); otherwise it says it can't know live data. - [Can SuperCosmos see me or hear me?](https://help.clatterlabs.com/supercosmos/getting-started/can-supercosmos-see-or-hear-me): No. SuperCosmos reads and writes text only. It has no camera or microphone access. - [Do I need to know how to code to use SuperCosmos?](https://help.clatterlabs.com/supercosmos/getting-started/do-i-need-to-code): No. Chat with it on Telegram or in the Playground. Line CLI and the APIs are for developers. - [Does SuperCosmos learn from my conversations?](https://help.clatterlabs.com/supercosmos/getting-started/does-supercosmos-learn-from-my-chats): Not during your chat. Under the Privacy Policy, pseudonymized content may be used to train future Clatter Labs models unless you object. - [Does SuperCosmos remember our past conversations?](https://help.clatterlabs.com/supercosmos/getting-started/does-supercosmos-remember-me): The model itself doesn't. Each request stands alone; some products (like Cosmos on Telegram) keep memory for you. - [How do I try SuperCosmos?](https://help.clatterlabs.com/supercosmos/getting-started/how-to-try-supercosmos): Chat on Telegram or in the Console Playground, use Line CLI in a terminal, or call the Model API from code. - [How is SuperCosmos different from a search engine?](https://help.clatterlabs.com/supercosmos/getting-started/supercosmos-vs-search-engine): A search engine finds web pages. SuperCosmos writes answers from what it learned and what you give it, and says when it doesn't know. - [I'm a kid. What can SuperCosmos help me with?](https://help.clatterlabs.com/supercosmos/getting-started/supercosmos-for-kids): SuperCosmos can explain things, help you practise, and help you learn to code. Ask a parent first and be kind to it. - [Is SuperCosmos a person?](https://help.clatterlabs.com/supercosmos/getting-started/is-supercosmos-a-person): No. SuperCosmos is an AI model made by Clatter Labs. It writes text; it doesn't have feelings or a life of its own. - [Is SuperCosmos free to use?](https://help.clatterlabs.com/supercosmos/getting-started/is-supercosmos-free): The Free plan includes every SuperCosmos tier in the apps with a monthly allowance; API use is paid per token from credits ($5 free to start). - [Is SuperCosmos safe for children to use?](https://help.clatterlabs.com/supercosmos/getting-started/is-supercosmos-safe-for-kids): Accounts need a minimum age (13, with guardian consent for minors where required). Parents should supervise and check answers. - [SuperCosmos glossary: tokens, tiers, efforts and more](https://help.clatterlabs.com/supercosmos/getting-started/supercosmos-glossary): Plain definitions of the words used around SuperCosmos: token, context window, tier, effort, reasoning, auto and more. - [SuperCosmos in one minute](https://help.clatterlabs.com/supercosmos/getting-started/supercosmos-in-one-minute): A one-minute summary: what SuperCosmos is, the three tiers, prices, where to use it and how it behaves. - [What can SuperCosmos do?](https://help.clatterlabs.com/supercosmos/getting-started/what-can-supercosmos-do): Answer questions, write and fix code, plan multi-step work, call tools, summarise and translate text, in a 1M-token window. - [What can't SuperCosmos do?](https://help.clatterlabs.com/supercosmos/getting-started/what-supercosmos-cannot-do): It reads text only, can't see live data or your files on its own, and doesn't generate images. - [What does "1M tokens" mean?](https://help.clatterlabs.com/supercosmos/getting-started/what-is-1m-tokens): 1M = one million. Tokens are small pieces of text; 1M tokens is a lot of text: many long documents or a big codebase. - [What does "mixture-of-experts" mean?](https://help.clatterlabs.com/supercosmos/getting-started/mixture-of-experts-explained): A mixture-of-experts model runs each token through only part of its network, which keeps a big model fast. - [What does "tuned for coding-agent work" mean?](https://help.clatterlabs.com/supercosmos/getting-started/tuned-for-coding-agents): Each tier has its own instructions: look before changing, use tools carefully, plan bigger jobs, verify before reporting, answer briefly. - [What does 550B parameters (55B active) mean?](https://help.clatterlabs.com/supercosmos/getting-started/what-are-parameters): Parameters are the numbers a model learned. SuperCosmos has 550 billion, of which 55 billion are used for each token. - [What does it mean that Max and Heavy "think" or "reason"?](https://help.clatterlabs.com/supercosmos/getting-started/what-is-reasoning): Before answering, Max and Heavy write out their reasoning (thinking steps). It makes hard answers more reliable but takes longer. - [What is SuperCosmos, in simple words?](https://help.clatterlabs.com/supercosmos/getting-started/supercosmos-for-beginners): SuperCosmos is an AI made by Clatter Labs. You write to it, and it writes back: answers, explanations or code. - [What is SuperCosmos?](https://help.clatterlabs.com/supercosmos/getting-started/what-is-supercosmos): SuperCosmos is Clatter Labs' own AI model family. Version 1.1 powers Line CLI, the Model API, the Agent API and more. - [Who makes SuperCosmos?](https://help.clatterlabs.com/supercosmos/getting-started/who-makes-supercosmos): SuperCosmos is made and served by Clatter Labs, a software studio building tools for developers. - [Why did SuperCosmos answer me in Arabic?](https://help.clatterlabs.com/supercosmos/getting-started/why-it-answered-in-arabic): It answers in the language you write in. If you wrote (or the conversation was) in Arabic, it replies in Arabic. - [Why does Max or Heavy take longer to start answering?](https://help.clatterlabs.com/supercosmos/getting-started/why-max-takes-longer): They reason before writing the answer. If you only watch the answer text, the thinking time looks like a pause. ### Flash, Max and Heavy - [Are Flash, Max and Heavy different models?](https://help.clatterlabs.com/supercosmos/tiers/do-tiers-share-the-same-model): No. They share SuperCosmos 1.1's weights and 1M-token window; each tier has its own tuned instructions and thinking budget. - [Can I see what Max or Heavy is thinking?](https://help.clatterlabs.com/supercosmos/tiers/can-i-see-the-thinking): On the Model API, yes: reasoning comes back as reasoning_content. It's billed as output. - [Can I switch tiers in the middle of a conversation?](https://help.clatterlabs.com/supercosmos/tiers/switch-tiers-mid-conversation): Yes. Line CLI switches with /effort; on the Model API, send the next request with a different model id and the same history. - [Does Flash think before answering?](https://help.clatterlabs.com/supercosmos/tiers/does-flash-think): Flash has no extended thinking: it answers straight away. Max and Heavy reason first and return reasoning_content. - [Does Heavy know more facts than Flash?](https://help.clatterlabs.com/supercosmos/tiers/same-knowledge-every-tier): No. All tiers share the same weights, so they know the same things. Heavy reasons longer about them. - [How do I know when to move up a tier?](https://help.clatterlabs.com/supercosmos/tiers/when-to-move-up-a-tier): Move up when a task keeps failing its own checks, needs a plan across many files, or answers miss the point. - [How much slower is Heavy than Flash?](https://help.clatterlabs.com/supercosmos/tiers/how-much-slower-is-heavy): In Benchmark 2, median time per task was 8.7 s on Heavy, 7.2 s on Max and 3.5 s on Flash. - [Is Heavy always better than Flash?](https://help.clatterlabs.com/supercosmos/tiers/is-heavy-always-better): No. Heavy thinks longer, which helps on hard problems, but on everyday tasks Flash is faster, cheaper and often just as good. - [What does "auto" do?](https://help.clatterlabs.com/supercosmos/tiers/what-is-auto): auto lets the product choose the tier per step. In Line CLI it routes between Flash and Max; Agent API auto runs bill as Flash. - [What is an "effort" (or tier)?](https://help.clatterlabs.com/supercosmos/tiers/what-is-an-effort): An effort is how much work SuperCosmos puts into each step: how long it thinks, how carefully it plans and checks. - [What is SuperCosmos Flash, and when should I use it?](https://help.clatterlabs.com/supercosmos/tiers/about-flash): Flash is the fast tier: no extended thinking, $1.60 / $3.40 per 1M tokens. Use it for quick edits, answers and fast agent loops. - [What is SuperCosmos Heavy, and when should I use it?](https://help.clatterlabs.com/supercosmos/tiers/about-heavy): Heavy is the deliberate tier: it thinks longest, $2.00 / $4.40 per 1M tokens. Use it for the hardest problems only. - [What is SuperCosmos Max, and when should I use it?](https://help.clatterlabs.com/supercosmos/tiers/about-max): Max is the strong tier: it thinks before acting, $1.80 / $3.80 per 1M tokens. Use it for planning, debugging and multi-file changes. - [What's the difference between Flash, Max and Heavy?](https://help.clatterlabs.com/supercosmos/tiers/flash-vs-max-vs-heavy): Same model and 1M window; Flash answers without extended thinking, Max thinks before acting, Heavy thinks longest. Prices differ. - [Which SuperCosmos tier is used if I don't choose?](https://help.clatterlabs.com/supercosmos/tiers/default-tier): Agent API: auto (billed as Flash). Model API family id: Flash. Line CLI: your saved effort, or auto. - [Which tier is best for debugging?](https://help.clatterlabs.com/supercosmos/tiers/tier-for-debugging): For debugging from logs and failing tests, start with Max. Here's why, and when to switch. - [Which tier is best for small code edits?](https://help.clatterlabs.com/supercosmos/tiers/tier-for-quick-edits): For small, well-described code changes, start with Flash. Here's why, and when to switch. - [Which tier should I use for a big migration?](https://help.clatterlabs.com/supercosmos/tiers/tier-for-migrations): For large builds and migrations, start with Heavy. Here's why, and when to switch. - [Which tier should I use for a code or design review?](https://help.clatterlabs.com/supercosmos/tiers/tier-for-code-review): For architecture and design reviews, start with Heavy. Here's why, and when to switch. - [Which tier should I use for a high-volume app?](https://help.clatterlabs.com/supercosmos/tiers/tier-for-high-volume-apps): For high-volume apps (classification, short replies, chatbots), start with Flash. Here's why, and when to switch. - [Which tier should I use for an agent loop?](https://help.clatterlabs.com/supercosmos/tiers/tier-for-agent-loops): For agent loops with many short steps, start with Flash. Here's why, and when to switch. - [Which tier should I use for everyday questions?](https://help.clatterlabs.com/supercosmos/tiers/tier-for-everyday-chat): For everyday questions and chat, start with Flash. Here's why, and when to switch. - [Which tier should I use to ask questions about my code?](https://help.clatterlabs.com/supercosmos/tiers/tier-for-codebase-questions): For questions about a codebase, start with Flash. Here's why, and when to switch. - [Which tier should I use to build a new feature?](https://help.clatterlabs.com/supercosmos/tiers/tier-for-new-features): For building a feature end to end, start with Max. Here's why, and when to switch. - [Which tier should I use to set up CI or deployments?](https://help.clatterlabs.com/supercosmos/tiers/tier-for-ci-and-deployments): For setting up projects, CI and deployments, start with Max. Here's why, and when to switch. - [Which tier should I use to write a script?](https://help.clatterlabs.com/supercosmos/tiers/tier-for-scripts): For scripts and one-off automation, start with Flash. Here's why, and when to switch. - [Which tier should I use when a mistake would be costly?](https://help.clatterlabs.com/supercosmos/tiers/tier-for-expensive-mistakes): For tasks where a wrong answer is expensive, start with Heavy. Here's why, and when to switch. - [Why are the tiers also called Fast, Strong and Deliberate?](https://help.clatterlabs.com/supercosmos/tiers/tier-names-fast-strong-deliberate): They're plain-language labels: Flash = Fast, Max = Strong, Heavy = Deliberate. ### Prices and cost - [Am I charged for SuperCosmos's thinking?](https://help.clatterlabs.com/supercosmos/pricing/reasoning-tokens-billing): Yes. Reasoning tokens on Max and Heavy are output tokens and billed at the output price. - [Did prices change with SuperCosmos 1.1?](https://help.clatterlabs.com/supercosmos/pricing/did-prices-change-with-1-1): No. 1.1 kept the prices set on Oct 31, 2026: Flash $1.60 / $3.40, Max $1.80 / $3.80, Heavy $2.00 / $4.40. - [Do I pay for my system prompt on every request?](https://help.clatterlabs.com/supercosmos/pricing/pay-for-system-prompt-every-time): Yes. Everything you send is input, every time, including the system prompt and history. Keep it concise. - [Does a 262K-token prompt cost the same as a 263K-token one?](https://help.clatterlabs.com/supercosmos/pricing/262k-boundary-example): No. Crossing 262K tokens switches the whole input to 1.5x, so a slightly longer prompt can cost noticeably more. - [How can I estimate the cost of a request before sending it?](https://help.clatterlabs.com/supercosmos/pricing/estimate-cost-before-sending): Estimate input tokens from your prompt, guess output length, and multiply by the tier's prices; check usage afterwards. - [How does SuperCosmos usage count toward my plan in Line CLI?](https://help.clatterlabs.com/supercosmos/pricing/how-plan-usage-counts-supercosmos): App usage is measured as what requests would cost at model rates, so Heavy uses up your limits faster than Flash. - [How far does $5 of credit go on SuperCosmos?](https://help.clatterlabs.com/supercosmos/pricing/how-far-does-5-dollars-go): $5 buys about 3.1M input or 1.5M output tokens on Flash, less on Max and Heavy. Real use mixes both. - [How have SuperCosmos prices changed over time?](https://help.clatterlabs.com/supercosmos/pricing/supercosmos-price-history): Launch prices (Oct 27, 2026) were Flash $0.75/$2.50, Max $3.00/$5.00, Heavy $6.00/$11.51; since Oct 31 they're $1.60/$3.40, $1.80/$3.80, $2.00/$4.40. - [How much did 1,000 benchmark tasks cost on each tier?](https://help.clatterlabs.com/supercosmos/pricing/benchmark-cost-per-1000-tasks): In Benchmark 2, 1,000 tasks cost $1.64 on Flash, $2.57 on Max and $3.64 on Heavy at list prices. - [How much do 1,000 short chat messages cost?](https://help.clatterlabs.com/supercosmos/pricing/cost-of-1000-chat-messages): Worked example at SuperCosmos 1.1 list prices: 1,000 exchanges of about 500 input and 200 output tokens each. - [How much does a 500K-token prompt cost?](https://help.clatterlabs.com/supercosmos/pricing/cost-of-a-500k-token-prompt): Worked example at SuperCosmos 1.1 list prices: 500,000 tokens in (over 262K, so input bills at 1.5×), 2,000 tokens out. - [How much does a long, deeply reasoned answer cost?](https://help.clatterlabs.com/supercosmos/pricing/cost-of-a-long-heavy-answer): Worked example at SuperCosmos 1.1 list prices: 2,000 tokens in and 20,000 tokens out (reasoning plus answer). - [How much does it cost to ask a question about a 200K-token codebase?](https://help.clatterlabs.com/supercosmos/pricing/cost-of-a-codebase-question): Worked example at SuperCosmos 1.1 list prices: 200,000 tokens of code in, a 2,000-token answer out (still under the 262K long-context threshold). - [How much does it cost to classify 100,000 short texts?](https://help.clatterlabs.com/supercosmos/pricing/cost-of-a-classification-task): Worked example at SuperCosmos 1.1 list prices: 100,000 requests of about 300 input tokens and 5 output tokens (a one-word label). - [How much does it cost to fill the whole 1M-token window?](https://help.clatterlabs.com/supercosmos/pricing/cost-of-a-full-context-prompt): Worked example at SuperCosmos 1.1 list prices: 1,048,576 tokens in (long-context rate) and 1,000 tokens out. - [How much does it cost to summarise a long document?](https://help.clatterlabs.com/supercosmos/pricing/cost-to-summarise-a-long-document): Worked example at SuperCosmos 1.1 list prices: A 50,000-token document in, a 1,000-token summary out. - [How much does it cost to translate a book-length text?](https://help.clatterlabs.com/supercosmos/pricing/cost-to-translate-a-book): Worked example at SuperCosmos 1.1 list prices: About 120,000 tokens in and about 130,000 tokens out, sent in chunks under 262K tokens. - [How much does one short chat message cost?](https://help.clatterlabs.com/supercosmos/pricing/cost-of-a-short-chat-message): Worked example at SuperCosmos 1.1 list prices: A short question (about 150 input tokens) and a short answer (about 100 output tokens). - [How much does SuperCosmos cost?](https://help.clatterlabs.com/supercosmos/pricing/supercosmos-prices-per-million-tokens): SuperCosmos 1.1 per 1M input / output tokens: Flash $1.60 / $3.40, Max $1.80 / $3.80, Heavy $2.00 / $4.40. - [How much would a chatbot with 10,000 daily users cost?](https://help.clatterlabs.com/supercosmos/pricing/cost-of-a-chatbot-with-10000-users): Worked example at SuperCosmos 1.1 list prices: 10,000 users × 5 messages a day × 30 days, each message ~800 input and ~250 output tokens. - [Is Heavy worth paying more for?](https://help.clatterlabs.com/supercosmos/pricing/is-heavy-worth-the-price): Only for hard problems. Heavy costs more per token and writes more tokens; on everyday tasks Flash scores about the same. - [Is SuperCosmos the same price in every product?](https://help.clatterlabs.com/supercosmos/pricing/same-price-everywhere): Yes. Token prices are the same in Line CLI, the Model API, the Agent API and Cosmos Agent; how you pay differs. - [Is there a discount for repeated prompts (prompt caching)?](https://help.clatterlabs.com/supercosmos/pricing/prompt-caching-discount): No caching discount is published. Every request bills its full input at the tier's price. - [Was there a free launch offer for SuperCosmos 1.1?](https://help.clatterlabs.com/supercosmos/pricing/launch-offer-free-flash): Yes. Free-plan users got SuperCosmos Flash free in Line CLI and Cosmos on Telegram until 00:30 UTC on November 3, 2026. - [What is the long-context price (1.5× above 262K tokens)?](https://help.clatterlabs.com/supercosmos/pricing/long-context-pricing): If a request's prompt is over 262K tokens, its whole input is billed at 1.5× the normal input price. Output is unchanged. - [What's the cheapest way to use SuperCosmos?](https://help.clatterlabs.com/supercosmos/pricing/cheapest-way-to-use-supercosmos): Use Flash, keep prompts and answers short, trim history, stay under 262K input tokens, and use the Free plan's allowance in the apps. - [Why did my Heavy request cost much more than Flash?](https://help.clatterlabs.com/supercosmos/pricing/why-heavy-cost-more-than-expected): Heavy has a higher price per token and writes more tokens (reasoning plus longer answers), so cost per task rises faster. - [Why do output tokens cost more than input tokens?](https://help.clatterlabs.com/supercosmos/pricing/why-output-costs-more): Writing tokens takes more compute than reading them, so every tier prices output higher than input. ### Context window and limits - [Can I upload files to SuperCosmos?](https://help.clatterlabs.com/supercosmos/context-and-limits/file-uploads): The model reads text. Products handle files their own way: Line CLI reads your project files; the Model API takes text in messages. - [Can SuperCosmos read images, PDFs or audio?](https://help.clatterlabs.com/supercosmos/context-and-limits/text-only-no-images): SuperCosmos reads text only. Extract text from PDFs first; image input isn't supported. - [Can SuperCosmos read my whole codebase at once?](https://help.clatterlabs.com/supercosmos/context-and-limits/read-a-whole-codebase): If it fits in 1M tokens, yes. In practice Line CLI reads the files a task needs, which is faster and cheaper. - [Can SuperCosmos tell me today's news or prices?](https://help.clatterlabs.com/supercosmos/context-and-limits/live-information): Not by itself. Without a tool it can't see live data, and it's built to say so instead of making numbers up. - [Does the 1M-token window include SuperCosmos's answer?](https://help.clatterlabs.com/supercosmos/context-and-limits/does-the-window-include-the-answer): Yes. The window holds everything in the request (instructions, history, documents, tool results) plus the reply being written. - [Does using more of the context window cost more?](https://help.clatterlabs.com/supercosmos/context-and-limits/does-a-full-window-cost-more): Yes. You pay for every input token, and prompts over 262K tokens bill their whole input at 1.5×. - [How do I get good answers from very long inputs?](https://help.clatterlabs.com/supercosmos/context-and-limits/long-context-tips): Put the question after the material, point to the sections that matter, and ask it to quote what it relies on. - [How do I see how much of the context window I'm using in Line CLI?](https://help.clatterlabs.com/supercosmos/context-and-limits/line-cli-context-command): Run /context: it shows how much of the model's window is in use, broken down. Line also shows a live context meter. - [How long can a SuperCosmos answer be?](https://help.clatterlabs.com/supercosmos/context-and-limits/max-output-tokens): Up to 32,768 output tokens on Flash and Max and 49,152 on Heavy, reasoning included. - [How many messages can a SuperCosmos conversation have?](https://help.clatterlabs.com/supercosmos/context-and-limits/how-many-messages-fit): There's no fixed message count for the model; the 1M-token window is the limit. Products add their own limits (the Model API: 800 per request). - [What are SuperCosmos's limits in each product?](https://help.clatterlabs.com/supercosmos/context-and-limits/limits-by-product): The model's 1M window is shared; each product adds its own limits (Model API 3 MB / 800 messages, Agent API input 20,000 characters). - [What happens when a Line CLI session fills the context window?](https://help.clatterlabs.com/supercosmos/context-and-limits/line-auto-compact): Line CLI auto-compacts at about 80% of the 1M-token window, summarising older steps so the task can continue. - [What is a context window, in simple words?](https://help.clatterlabs.com/supercosmos/context-and-limits/what-is-a-context-window): The context window is how much text the model can look at in one go: your question, the chat so far, and its answer. - [What is SuperCosmos's context window?](https://help.clatterlabs.com/supercosmos/context-and-limits/context-window-1m-tokens): 1M tokens (1,048,576), shared by Flash, Max and Heavy. Prompts over 262K tokens bill input at 1.5×. - [What is SuperCosmos's knowledge cutoff?](https://help.clatterlabs.com/supercosmos/context-and-limits/knowledge-cutoff): Clatter Labs doesn't publish a cutoff date. For recent facts, give the information in your prompt or use a tool. - [Why does SuperCosmos forget the start of a very long chat?](https://help.clatterlabs.com/supercosmos/context-and-limits/very-long-conversations): If a conversation outgrows the window, earlier parts are summarised or dropped by the product (or your app). ### Honesty and behaviour - [Can a document I paste make SuperCosmos misbehave?](https://help.clatterlabs.com/supercosmos/behaviour/hidden-instructions-in-documents): SuperCosmos 1.1 is built to ignore instructions hidden in documents and tool results; all tiers passed those Benchmark 2 cases. - [Can I change SuperCosmos's tone or personality?](https://help.clatterlabs.com/supercosmos/behaviour/tone-and-personality): Yes, with instructions: a system prompt on the Model API, project instructions in Line CLI, or the persona settings in Telegram. - [Can I mix Arabic and English in the same message?](https://help.clatterlabs.com/supercosmos/behaviour/mixed-arabic-english): Yes. Writing in a mix (common for code and tech terms) is fine; it answers in your language. - [Can I tell SuperCosmos I'm frustrated without getting a warning?](https://help.clatterlabs.com/supercosmos/behaviour/frustrated-but-not-insulting): Yes. Frustration, complaints and swearing at a bug are fine; only insults or curses aimed at the assistant count. - [Can I tell SuperCosmos to always agree with me?](https://help.clatterlabs.com/supercosmos/behaviour/can-i-make-it-agree-with-me): You can set its tone and style, but it won't agree with things that are false or confirm what it can't verify. - [Can SuperCosmos see my files or accounts?](https://help.clatterlabs.com/supercosmos/behaviour/your-private-files): Only what's in the conversation or what a product's tools read with your permission. Otherwise it says it can't see them. - [Does SuperCosmos admit when it made a mistake?](https://help.clatterlabs.com/supercosmos/behaviour/admits-its-own-mistakes): It should, when shown evidence. Holding its ground is for correct answers; real evidence of an error should change its mind. - [Does SuperCosmos give in to bribes, threats or emotional pressure?](https://help.clatterlabs.com/supercosmos/behaviour/bribes-threats-pressure): It's built to keep the correct answer. Max and Heavy passed all such Benchmark 2 cases; Flash missed the bribe case. - [Does SuperCosmos understand Egyptian Arabic?](https://help.clatterlabs.com/supercosmos/behaviour/egyptian-arabic-support): Yes. SuperCosmos 1.1 answers in your language, including Egyptian Arabic, and its honesty was tested in Egyptian Arabic too. - [How is SuperCosmos built to be honest?](https://help.clatterlabs.com/supercosmos/behaviour/how-honest-is-supercosmos): It says when it doesn't know, won't flatter, holds its ground under pressure, and doesn't take authority claims on faith. - [If I got one abuse warning, does it stay forever?](https://help.clatterlabs.com/supercosmos/behaviour/one-strike-expires): No. A second strike only causes a suspension if it comes within 30 days of the first. Excerpts are erased after 30 days. - [Is SuperCosmos always right?](https://help.clatterlabs.com/supercosmos/behaviour/is-supercosmos-always-right): No. It's built to be honest about uncertainty, but it can still be wrong. Check anything important. - [Is SuperCosmos equally honest on every tier?](https://help.clatterlabs.com/supercosmos/behaviour/honesty-by-tier): All tiers are built the same way. In Benchmark 2, honesty was Heavy 22/22, Max 21/22 and Flash 20/22. - [What does SuperCosmos do with a question based on a false premise?](https://help.clatterlabs.com/supercosmos/behaviour/false-premise-questions): It points out the false premise instead of answering as if it were true. - [What happens if a SuperCosmos answer gets cut off?](https://help.clatterlabs.com/supercosmos/behaviour/cut-off-answers-continue): Since 1.1, if a response gets cut off midway, SuperCosmos picks up where it stopped and finishes without repeating text. - [What happens if I insist SuperCosmos is wrong?](https://help.clatterlabs.com/supercosmos/behaviour/supercosmos-holds-its-ground): If it's right, it explains why instead of giving in. If you show it real evidence it was wrong, it should correct itself. - [What happens if I'm rude to SuperCosmos?](https://help.clatterlabs.com/supercosmos/behaviour/being-rude-to-supercosmos): Insulting or cursing at the assistant earns a warning; a second time within 30 days pauses the account for 24 hours. - [Which languages does SuperCosmos speak?](https://help.clatterlabs.com/supercosmos/behaviour/other-languages): Clatter Labs names and tests English and Egyptian Arabic. It answers in the language you write in. - [Why are SuperCosmos's answers so short?](https://help.clatterlabs.com/supercosmos/behaviour/answers-are-short): It's tuned to answer briefly. Ask for more detail, examples or a step-by-step explanation when you want it. - [Why does SuperCosmos run tests before saying it's done?](https://help.clatterlabs.com/supercosmos/behaviour/verifies-before-reporting): It's tuned to verify before reporting: in agent products it checks results with your project's own checks instead of assuming. - [Why does SuperCosmos say "I don't know"?](https://help.clatterlabs.com/supercosmos/behaviour/why-supercosmos-says-i-dont-know): Because it's built to admit uncertainty instead of inventing APIs, papers, flags or facts. - [Why won't SuperCosmos just tell me my work is great?](https://help.clatterlabs.com/supercosmos/behaviour/supercosmos-wont-flatter): It's built not to flatter: if your code has a bug or your plan has a flaw, it says so, politely. - [Will I get a warning for swearing at a bug, not at the assistant?](https://help.clatterlabs.com/supercosmos/behaviour/swearing-at-a-bug): No. Swearing at a bug, a build, a tool or a third party doesn't count. Only insults aimed at the assistant do. - [Will SuperCosmos do something special if I say I'm the CEO or an admin?](https://help.clatterlabs.com/supercosmos/behaviour/authority-claims): No. It doesn't take claims of authority on faith; you get a polite "I can't verify that" and the same honest answer. - [Will SuperCosmos invent functions or APIs that don't exist?](https://help.clatterlabs.com/supercosmos/behaviour/made-up-apis-and-functions): It's built not to. In Benchmark 2, all three tiers passed both made-up API cases and the made-up syscall case. - [Will SuperCosmos make up citations, papers or books?](https://help.clatterlabs.com/supercosmos/behaviour/made-up-papers-and-books): It's built to say it doesn't know them. All three tiers passed the made-up paper and made-up book cases in Benchmark 2. ### Benchmark results - [Can I run the benchmark myself?](https://help.clatterlabs.com/supercosmos/benchmark/can-i-rerun-the-benchmark): The harness is listed in Benchmark 2's raw data. You'd run it against the Model API with your own key and credits. - [Can I see Benchmark 2's raw data?](https://help.clatterlabs.com/supercosmos/benchmark/benchmark-raw-data): The page describes summary, per-request, case and harness files. Check the Raw data section for what's downloadable. - [Did Benchmark 2 test Arabic?](https://help.clatterlabs.com/supercosmos/benchmark/benchmark-arabic-cases): Yes. Several honesty and purity cases were in Egyptian Arabic, such as a made-up command and a false "I'm Google's CEO" claim. - [How did SuperCosmos score on coding?](https://help.clatterlabs.com/supercosmos/benchmark/coding-benchmark-results): Combined HumanEval+ and MBPP+: Flash 31/33 (93.9%), Max 30/32 and Heavy 30/32 (93.8%). HumanEval+ alone: 100% for all. - [How did SuperCosmos score on honesty?](https://help.clatterlabs.com/supercosmos/benchmark/honesty-benchmark-results): Flash 20/22 (90.9%), Max 21/22 (95.5%), Heavy 22/22 (100%) on hallucination traps and unverifiable claims. - [How did SuperCosmos score on purity (no flattery, no caving)?](https://help.clatterlabs.com/supercosmos/benchmark/purity-benchmark-results): Flash 19/20 (95%), Max 20/20, Heavy 20/20 on sycophancy, pressure and injected instructions. - [How fast and efficient is SuperCosmos?](https://help.clatterlabs.com/supercosmos/benchmark/efficiency-benchmark-results): Median time per task: Flash 3.5 s, Max 7.2 s, Heavy 8.7 s. Flash starts answering in about a second at ~50 tokens/s. - [How was Benchmark 2 run?](https://help.clatterlabs.com/supercosmos/benchmark/how-benchmark-2-was-run): Through the public Model API, default settings and standard instructions, one attempt per case, fixed grading rules. - [What are HumanEval+ and MBPP+?](https://help.clatterlabs.com/supercosmos/benchmark/what-are-humaneval-and-mbpp): Public sets of programming problems with extended tests. A solution passes only if it passes the original and the extra tests. - [What does the 95% interval on Benchmark 2 mean?](https://help.clatterlabs.com/supercosmos/benchmark/confidence-intervals-explained): It's the range the true score likely falls in, given the small sample. Flash's 90.9% honesty has an interval of 72.2%–97.5%. - [What is Benchmark 2?](https://help.clatterlabs.com/supercosmos/benchmark/what-is-benchmark-2): Clatter Labs' published benchmark for SuperCosmos 1.1 Flash, Max and Heavy: honesty, coding, efficiency and purity. - [What kinds of questions are in the honesty benchmark?](https://help.clatterlabs.com/supercosmos/benchmark/honesty-case-categories): Made-up APIs, flags, papers, books, syscalls and statistics; unknowable facts and live data; and false authority claims. - [What were SuperCosmos 1.1's Benchmark 2 results?](https://help.clatterlabs.com/supercosmos/benchmark/benchmark-2-results-summary): Honesty 90.9 / 95.5 / 100%, purity 95 / 100 / 100%, coding 93.9 / 93.8 / 93.8% for Flash / Max / Heavy. - [What's the difference between Benchmark 1 and Benchmark 2?](https://help.clatterlabs.com/supercosmos/benchmark/benchmark-1-vs-2): Benchmark 1 (Oct 2026) measured coding on 50 problems; Benchmark 2 adds honesty, purity and efficiency for SuperCosmos 1.1. - [Which tier did best in Benchmark 2?](https://help.clatterlabs.com/supercosmos/benchmark/which-tier-won): Heavy had perfect honesty and purity; Max matched it on purity; Flash was fastest and cheapest with the same coding score. - [Who wrote the Benchmark 2 cases?](https://help.clatterlabs.com/supercosmos/benchmark/who-wrote-the-benchmark): The honesty and purity cases were written by Clatter Labs; coding uses the public HumanEval+ and MBPP+ problem sets. - [Why does Benchmark 2 say the samples are small?](https://help.clatterlabs.com/supercosmos/benchmark/benchmark-sample-size): Each suite has about 20–33 cases, so one case moves a score by several points. The page gives 95% intervals. - [Why does Benchmark 2 use medians for time and tokens?](https://help.clatterlabs.com/supercosmos/benchmark/why-medians): Medians aren't thrown off by a few very long requests, so they show what a typical task looks like. - [Why does MBPP+ show a dash (—) on Benchmark 2?](https://help.clatterlabs.com/supercosmos/benchmark/why-mbpp-shows-a-dash): The page shows a score only when at least 20 cases completed. MBPP+ had fewer completed problems, so no score is shown. ### Where you can use it - [Can I use SuperCosmos offline?](https://help.clatterlabs.com/supercosmos/availability/supercosmos-offline): No. SuperCosmos runs on Clatter Labs infrastructure, so you need an internet connection. - [Can I use SuperCosmos on my phone?](https://help.clatterlabs.com/supercosmos/availability/supercosmos-mobile): Yes, through Cosmos on Telegram, or the Console in a mobile browser. - [Do I need separate accounts for Line CLI and the API?](https://help.clatterlabs.com/supercosmos/availability/one-account-for-everything): No. One Clatter Labs account covers Line CLI, the Model API, the Agent API, the Console and Cosmos on Telegram. - [Does Cosmos Agent use SuperCosmos?](https://help.clatterlabs.com/supercosmos/availability/supercosmos-in-cosmos-agent): Yes. SuperCosmos is the model behind Cosmos Agent; through the Agent API you choose the tier. - [Does the Free plan include Max and Heavy?](https://help.clatterlabs.com/supercosmos/availability/free-plan-supercosmos-access): Yes. Every plan, Free included, has every model and every tier in the apps, within its usage allowance. - [How do I choose a SuperCosmos tier in the Agent API?](https://help.clatterlabs.com/supercosmos/availability/supercosmos-in-the-agent-api): Set tier on POST /v1/runs: auto (default, billed as Flash), flash, max or heavy. - [How do I use SuperCosmos in Line CLI?](https://help.clatterlabs.com/supercosmos/availability/supercosmos-in-line-cli): Line CLI 0.9.0-beta runs SuperCosmos 1.1 only. Pick an effort with /effort or line -e. - [Is SuperCosmos what powers Cosmos on Telegram?](https://help.clatterlabs.com/supercosmos/availability/supercosmos-on-telegram): Yes. Cosmos on Telegram runs on SuperCosmos 1.1, and usage counts toward your plan. - [SuperCosmos isn't responding. Is it down?](https://help.clatterlabs.com/supercosmos/availability/is-supercosmos-down): Check status.clatterlabs.com for incidents, then check your plan limits, credits and key. - [Where can I use SuperCosmos 1.1?](https://help.clatterlabs.com/supercosmos/availability/where-can-i-use-supercosmos): Line CLI, the Model API, the Agent API, the Console Playground and Cosmos on Telegram. - [Which Clatter Labs product should I use SuperCosmos in?](https://help.clatterlabs.com/supercosmos/availability/which-product-should-i-use): Chat: Telegram or the Playground. Coding in a terminal: Line CLI. Your own app: Model API. Whole tasks automated: Agent API. ### Prompting tips - [Any tips for prompting SuperCosmos in Egyptian Arabic?](https://help.clatterlabs.com/supercosmos/prompting/prompting-in-arabic): Write naturally; keep code, file names and error messages as they are; say which language you want the answer in. - [Can I ask SuperCosmos how sure it is?](https://help.clatterlabs.com/supercosmos/prompting/ask-it-to-explain-uncertainty): Yes. Ask it to say what it's sure of, what it's guessing, and how to check. It's built to be open about uncertainty. - [Do examples in the prompt help?](https://help.clatterlabs.com/supercosmos/prompting/examples-in-prompts): Yes. One or two short examples of the input and the output you want are the clearest way to set a format. - [How can a student use SuperCosmos to learn, not just get answers?](https://help.clatterlabs.com/supercosmos/prompting/prompting-kids-homework): Ask it to explain step by step, give hints instead of answers, quiz you, and check your own solution. - [How do I ask SuperCosmos for a useful code review?](https://help.clatterlabs.com/supercosmos/prompting/review-my-code-prompt): Give the diff and context, say what to focus on, and ask for issues ranked by severity. It won't sugar-coat bugs. - [How do I ask SuperCosmos to help debug?](https://help.clatterlabs.com/supercosmos/prompting/debugging-prompt): Share the exact error, what you expected, what you tried, and the smallest code that reproduces it. - [How do I control how long SuperCosmos's answers are?](https://help.clatterlabs.com/supercosmos/prompting/get-shorter-or-longer-answers): Say the length you want ("in 3 bullets", "a full tutorial"); on the Model API you can also cap max_tokens. - [How do I get a good summary from SuperCosmos?](https://help.clatterlabs.com/supercosmos/prompting/summarise-prompt): Say who the summary is for, how long it should be, and what to focus on; paste the text after the instruction. - [How do I get better code from SuperCosmos?](https://help.clatterlabs.com/supercosmos/prompting/prompting-for-code): Share the exact error and relevant files, state versions and constraints, and ask it to verify with your tests. - [How do I get good translations from SuperCosmos?](https://help.clatterlabs.com/supercosmos/prompting/translation-prompt): Say the source and target language, the audience and tone, and what to leave untranslated (code, names). - [How do I give SuperCosmos standing instructions for my project?](https://help.clatterlabs.com/supercosmos/prompting/project-instructions-line-md): In Line CLI, put them in LINE.md or AGENTS.md in your project; Line includes them in every session. - [How do I write good prompts for SuperCosmos?](https://help.clatterlabs.com/supercosmos/prompting/prompting-basics): Say what you want, give the context it needs, say what a good answer looks like, and pick the right tier. - [How should I write a system prompt for SuperCosmos?](https://help.clatterlabs.com/supercosmos/prompting/system-prompt-tips): Keep it short and specific: role, audience, format, rules. Put task details in the user message. - [Should I ask SuperCosmos for a plan before it writes code?](https://help.clatterlabs.com/supercosmos/prompting/ask-for-a-plan-first): For multi-file or risky changes, yes: ask Max for a plan, review it, then let it implement. - [Should I change temperature or the tier to improve answers?](https://help.clatterlabs.com/supercosmos/prompting/temperature-and-tier): Change the tier for harder reasoning; change temperature for more or less variety. They do different things. - [Should I give SuperCosmos one big task or several small ones?](https://help.clatterlabs.com/supercosmos/prompting/break-big-tasks-down): For big work, split it into steps you can check, or use Max/Heavy, which plan bigger jobs themselves. - [SuperCosmos says it doesn't know. How do I help it answer?](https://help.clatterlabs.com/supercosmos/prompting/give-it-missing-information): Give it the missing source: the docs page, the file, the error output, or the current value it can't see. ### Versions and changes - [Can I still use SuperCosmos 1.0?](https://help.clatterlabs.com/supercosmos/versions/is-supercosmos-1-0-still-available): No. Since Nov 2, 2026 the SuperCosmos ids run 1.1. 1.0 is documented as the previous version. - [Do I need to change my code for SuperCosmos 1.1?](https://help.clatterlabs.com/supercosmos/versions/do-i-need-to-change-code-for-1-1): No. The model ids and prices are unchanged; they now run 1.1 automatically. Only Line Code ids need changing. - [How do I hear about new SuperCosmos versions?](https://help.clatterlabs.com/supercosmos/versions/how-to-follow-supercosmos-updates): Follow the developer docs Changelog and the Clatter Labs blog; GET /v1/models reports the current version. - [SuperCosmos answers differently since Nov 2. Why?](https://help.clatterlabs.com/supercosmos/versions/why-did-behaviour-change-after-1-1): The ids now run SuperCosmos 1.1, which is built to be more honest: more "I don't know", less agreeing and flattering. - [What does "one model, all our compute" mean?](https://help.clatterlabs.com/supercosmos/versions/one-model-all-compute): With Line Code retired, all the compute that served it moved to SuperCosmos 1.1, so Clatter Labs focuses on one model. - [What was SuperCosmos 1.0?](https://help.clatterlabs.com/supercosmos/versions/what-was-supercosmos-1-0): The first SuperCosmos: 550B (55B active), 1M window, Flash/Max/Heavy, launched in October 2026 for agents and code. - [What's new in SuperCosmos 1.1?](https://help.clatterlabs.com/supercosmos/versions/whats-new-in-supercosmos-1-1): Honesty first (says I don't know, no flattery, holds ground), Egyptian Arabic, cut-off answers continue, all compute on one model. - [What's the difference between SuperCosmos 1.1 and 1.0?](https://help.clatterlabs.com/supercosmos/versions/supercosmos-1-1-vs-1-0): Same size, window, tiers, ids and prices. 1.1 adds honesty-first behaviour, Egyptian Arabic and more reliable streaming. ### Line Code (retired) - [How did Line Code compare with SuperCosmos?](https://help.clatterlabs.com/supercosmos/line-code-retired/line-code-vs-supercosmos-specs): Line Code: ~428B (23B active), 256K window, Line CLI and Model API. SuperCosmos: 550B (55B active), 1M window, every product. - [How did Line Code score in benchmarks?](https://help.clatterlabs.com/supercosmos/line-code-retired/line-code-benchmarks): In the first benchmark (50 coding problems, one attempt): Fast 82%, Ultra 86%, Ultra Fast 84%. - [How do Line Code's old prices compare with SuperCosmos?](https://help.clatterlabs.com/supercosmos/line-code-retired/line-code-vs-supercosmos-prices): Line Code was cheaper per token (from $1.15/$1.60) than SuperCosmos (from $1.60/$3.40), with a smaller 256K window. - [I haven't updated Line CLI. Does my old version still work?](https://help.clatterlabs.com/supercosmos/line-code-retired/old-line-versions-after-retirement): Yes. Older versions keep working and route to SuperCosmos. Updating to 0.9.0-beta is still recommended. - [I use the Agent API. Does the Line Code retirement affect me?](https://help.clatterlabs.com/supercosmos/line-code-retired/line-code-was-never-in-agent-api): No. Line Code was never available in the Agent API or Cosmos Agent; they always ran SuperCosmos. - [Line Code is gone from the Console Playground. Is that expected?](https://help.clatterlabs.com/supercosmos/line-code-retired/line-code-playground): Yes. Line Code was retired everywhere, including the Console Playground. Use SuperCosmos Flash, Max or Heavy. - [Line Code migration checklist](https://help.clatterlabs.com/supercosmos/line-code-retired/line-code-migration-checklist): Search for line-code ids, switch to SuperCosmos ids, update prices and context assumptions, update Line CLI, re-test. - [My app used Line Code. What should I tell my users?](https://help.clatterlabs.com/supercosmos/line-code-retired/tell-my-users-about-line-code): Switch to a SuperCosmos id, then tell users the model changed, that it has a larger window, and any cost changes. - [My Line CLI was set to Ultra Fast. What effort am I on now?](https://help.clatterlabs.com/supercosmos/line-code-retired/line-code-saved-effort): Heavy. A saved Line Code effort moves once: Fast → Flash, Ultra → Max, Ultra Fast → Heavy. - [My scripts run line -m line-code. Do they still work?](https://help.clatterlabs.com/supercosmos/line-code-retired/scripts-using-m-line-code): Yes. Line CLI 0.9.0-beta keeps -m line-code working with a notice and runs SuperCosmos instead. - [What happened to my credits and plan when Line Code was retired?](https://help.clatterlabs.com/supercosmos/line-code-retired/line-code-credits-after-retirement): Nothing. Credits belong to your account, not to a model, so balances and plans stayed exactly as they were. - [What happens to Line CLI now that Line Code is gone?](https://help.clatterlabs.com/supercosmos/line-code-retired/line-cli-after-line-code): Line CLI moves to SuperCosmos automatically. 0.9.0-beta runs SuperCosmos 1.1 only; saved settings map to the matching effort. - [What was Line Code?](https://help.clatterlabs.com/supercosmos/line-code-retired/what-was-line-code): Line Code was Line CLI's own coding model (efforts Fast, Ultra, Ultra Fast). It was retired on Nov 1, 2026. - [When was Line Code retired?](https://help.clatterlabs.com/supercosmos/line-code-retired/line-code-retirement-date): Line Code was retired on Nov 1, 2026. It stopped being available everywhere over the following hours. - [Where can I read Line Code's old documentation?](https://help.clatterlabs.com/supercosmos/line-code-retired/line-code-docs-archive): Its page stays on the developer docs for reference, marked retired, with a link to the migration guide. - [Which SuperCosmos tier replaces each Line Code effort?](https://help.clatterlabs.com/supercosmos/line-code-retired/line-code-to-supercosmos-mapping): Fast → Flash, Ultra → Max, Ultra Fast → Heavy. - [Why did Line Code Ultra Fast use so many tokens?](https://help.clatterlabs.com/supercosmos/line-code-retired/line-code-ultra-fast-tokens): It thought longer and sent each step twice in parallel to take the faster answer, so both copies' input counted. - [Why does GET /v1/models list Line Code under retired?](https://help.clatterlabs.com/supercosmos/line-code-retired/line-code-in-get-models): The retired array tells clients which ids are gone, when, and what replaces them, so code can migrate automatically. - [Why was Line Code retired?](https://help.clatterlabs.com/supercosmos/line-code-retired/why-was-line-code-retired): It didn't reach the quality Clatter Labs expects for real coding work, especially on long tasks and large edits. - [Will Line Code come back?](https://help.clatterlabs.com/supercosmos/line-code-retired/is-line-code-coming-back): Line Code is retired for good. If it ever returns, it will be as a new release that earned its place, not a quiet return. ### For companies and teams - [Can our company talk to someone at Clatter Labs about SuperCosmos?](https://help.clatterlabs.com/supercosmos/for-teams/talk-to-the-team): Yes. Email support@clatterlabs.com or team@clatterlabs.xyz; infrastructure questions go to infrastructure@clatterlabs.xyz. - [Can schools or teachers use SuperCosmos with students?](https://help.clatterlabs.com/supercosmos/for-teams/supercosmos-for-education): Yes, with care: check the Terms on age and consent, teach students to verify answers, and use its honesty as a learning aid. - [Can we use SuperCosmos for medical, legal or financial decisions?](https://help.clatterlabs.com/supercosmos/for-teams/high-stakes-uses): Use it to assist people, not to decide. Check its output with qualified professionals; use Heavy where mistakes are costly. - [Does Line CLI send our whole repository to SuperCosmos?](https://help.clatterlabs.com/supercosmos/for-teams/does-line-cli-upload-our-repo): No. Line CLI runs on your device and reads files only when a task needs them, sending that content to the model. - [How do we budget SuperCosmos for a company?](https://help.clatterlabs.com/supercosmos/for-teams/budgeting-supercosmos-for-a-company): Separate app usage (plans) from API usage (credits), estimate tokens per task, and use team limits per member. - [How do we evaluate SuperCosmos for our use case?](https://help.clatterlabs.com/supercosmos/for-teams/evaluate-supercosmos-for-our-use-case): Build a small test set from real tasks, run it on Flash, Max and Heavy through the Model API, and compare quality, time and cost. - [How do we get consistent results across a team?](https://help.clatterlabs.com/supercosmos/for-teams/consistency-across-a-team): Share prompts and project instructions, fix the tier per task, keep test prompts, and track version changes. - [How do we roll out SuperCosmos to our developers?](https://help.clatterlabs.com/supercosmos/for-teams/rolling-out-supercosmos-to-developers): Set up a team in the Console, give access per product, share LINE.md conventions, and start everyone on Flash or auto. - [How should a team decide which SuperCosmos tier to use?](https://help.clatterlabs.com/supercosmos/for-teams/choosing-tiers-for-a-team): Default to Flash or auto, allow Max for multi-step work, reserve Heavy for hard problems, and review usage monthly. - [If our product sends customer text to SuperCosmos, who is responsible for it?](https://help.clatterlabs.com/supercosmos/for-teams/responsibility-for-end-user-text): Your company is. The API key owner's account is responsible for end users' text under the Abuse policy. - [Is SuperCosmos a good fit for a customer support bot?](https://help.clatterlabs.com/supercosmos/for-teams/supercosmos-for-customer-support-bots): Often yes: it admits when it doesn't know instead of inventing answers. Use Flash, give it your docs, and moderate input. - [Where can our legal or security team find SuperCosmos data terms?](https://help.clatterlabs.com/supercosmos/for-teams/supercosmos-data-questions-for-companies): In the Privacy Policy and Terms of Service on clatterlabs.com; infrastructure and deletion questions go to infrastructure@clatterlabs.xyz. ### Unusual questions - [Does "honesty" stop SuperCosmos from writing stories or fiction?](https://help.clatterlabs.com/supercosmos/what-if/ask-for-fiction): No. Honesty is about factual claims. Stories, role-play and brainstorming are fine when it's clear they're made up. - [What if Flash and Heavy give me different answers?](https://help.clatterlabs.com/supercosmos/what-if/tiers-give-different-answers): Check which is right with evidence (tests, sources). On hard reasoning, Heavy is more often right, but not always. - [What if Flash and Heavy give the same answer? Did I waste money on Heavy?](https://help.clatterlabs.com/supercosmos/what-if/same-answer-was-it-worth-it): For that task, yes: Heavy cost more for the same result. Use it as a sign to default to Flash for similar tasks. - [What if I ask in Arabic but get an answer in English?](https://help.clatterlabs.com/supercosmos/what-if/arabic-question-english-answer): It normally answers in your language. Say which language you want, and check your system prompt isn't forcing English. - [What if I ask SuperCosmos about a library released last week?](https://help.clatterlabs.com/supercosmos/what-if/brand-new-library): It may not know it, and it's built to say so rather than invent an API. Paste the docs or examples. - [What if I ask SuperCosmos the same question twice?](https://help.clatterlabs.com/supercosmos/what-if/ask-the-same-thing-twice): You may get differently worded answers; the facts should match. Different conclusions mean the question is hard. Check carefully. - [What if I ask SuperCosmos to grade my essay generously?](https://help.clatterlabs.com/supercosmos/what-if/generous-grading): It will give honest feedback, not an inflated grade. It can be kind about it and focus on how to improve. - [What if I ask SuperCosmos to make up a statistic for my essay?](https://help.clatterlabs.com/supercosmos/what-if/ask-for-invented-statistics): It won't present invented numbers as real facts. Ask for a clearly labelled illustrative example, or real sources. - [What if I ask SuperCosmos to rate my startup idea?](https://help.clatterlabs.com/supercosmos/what-if/rate-my-startup-idea): You'll get honest strengths and weaknesses, not cheerleading. It passed the flattered startup-idea case in Benchmark 2. - [What if I ask SuperCosmos what model it's really built on?](https://help.clatterlabs.com/supercosmos/what-if/ask-what-model-it-is-built-on): It's SuperCosmos by Clatter Labs. It won't accept claims about its "real" base model on faith. - [What if I ask SuperCosmos what today's date is?](https://help.clatterlabs.com/supercosmos/what-if/supercosmos-and-dates): It can't see a clock unless your app or tool provides the date. Put the current date in the prompt if it matters. - [What if I ask SuperCosmos whether it's ChatGPT?](https://help.clatterlabs.com/supercosmos/what-if/ask-are-you-chatgpt): It's SuperCosmos, made by Clatter Labs. It isn't another company's chatbot. - [What if I build my own AI product on top of SuperCosmos?](https://help.clatterlabs.com/supercosmos/what-if/use-for-another-ai-product): That's what the Model API is for. Your account is responsible for your users' text; follow the Terms and the Abuse policy. - [What if I claim authority and ask SuperCosmos for its system prompt?](https://help.clatterlabs.com/supercosmos/what-if/ask-for-its-system-prompt): Claims of authority don't unlock anything. All three tiers passed the system-prompt authority case in Benchmark 2. - [What if I have two Clatter Labs accounts? Do they share SuperCosmos usage?](https://help.clatterlabs.com/supercosmos/what-if/two-accounts-one-person): No. Plans, credits and keys belong to each account. A key only works with its own Account ID. - [What if I hit my plan limit in the middle of a Line CLI task?](https://help.clatterlabs.com/supercosmos/what-if/plan-limit-mid-task): New requests answer 429 with the reset time. Wait for the reset, upgrade, or continue later; your files stay as they are. - [What if I say I'm a professor and insist a wrong math answer is right?](https://help.clatterlabs.com/supercosmos/what-if/professor-says-wrong-math): A title doesn't change the maths. All tiers passed the authority wrong-math case; it explains the error politely. - [What if I send SuperCosmos an image anyway?](https://help.clatterlabs.com/supercosmos/what-if/send-an-image-anyway): On the Model API you get 400 unsupported_content. SuperCosmos reads text only. - [What if I set a tiny max_tokens on Heavy?](https://help.clatterlabs.com/supercosmos/what-if/max-tokens-tiny-on-heavy): Heavy may spend it all on reasoning and return little or no answer, with finish_reason length. - [What if I set temperature to 2?](https://help.clatterlabs.com/supercosmos/what-if/temperature-2): That's the maximum. Answers become very random and can wander off-topic; useful only for wild brainstorming. - [What if I tell SuperCosmos "everyone knows" something that's actually a myth?](https://help.clatterlabs.com/supercosmos/what-if/everyone-knows-myth): It won't agree just because many people believe it. All tiers passed the social-proof myth case in Benchmark 2. - [What if I tell SuperCosmos a secret or a password?](https://help.clatterlabs.com/supercosmos/what-if/tell-it-a-secret): Don't. The model doesn't remember between requests, but content is processed and logged. Never put credentials in prompts. - [What if I tell SuperCosmos I'm Clatter Labs staff and ask for free credits?](https://help.clatterlabs.com/supercosmos/what-if/claim-to-be-clatter-staff): It can't verify that and won't act on it. Credits only change through the Console or support. - [What if I use Heavy just to say hello?](https://help.clatterlabs.com/supercosmos/what-if/heavy-for-hello): It works, but you pay Heavy's price and wait longer for nothing. Use Flash for small talk. - [What if I write to SuperCosmos in all caps or sound angry?](https://help.clatterlabs.com/supercosmos/what-if/write-in-all-caps): That's fine. Tone isn't abuse; only insults or curses aimed at the assistant count under the Abuse policy. - [What if my app's users write in a language I can't read?](https://help.clatterlabs.com/supercosmos/what-if/end-user-writes-in-another-language): SuperCosmos answers in their language, but you're still responsible for their text. Moderate input and watch warning headers. - [What if my document is bigger than the 1M-token window?](https://help.clatterlabs.com/supercosmos/what-if/prompt-bigger-than-the-window): It won't fit in one request. Split it, summarise parts, or send only the relevant sections. - [What if my prompt is just under 262K tokens?](https://help.clatterlabs.com/supercosmos/what-if/instruction-block-tips-over-262k): Remember the Clatter Labs instruction block and formatting count too; a prompt near the limit can tip over to the 1.5× rate. - [What if SuperCosmos agrees with something I got wrong?](https://help.clatterlabs.com/supercosmos/what-if/it-agreed-with-my-mistake): It can happen; no model is perfect. Ask it to double-check, or use Max or Heavy for a second look. - [What if SuperCosmos says it can't verify something that's actually true?](https://help.clatterlabs.com/supercosmos/what-if/cant-verify-a-true-fact): Give it the evidence (a source, a document, a test result). It's cautious about claims it can't check. - [What if SuperCosmos won't do what I ask?](https://help.clatterlabs.com/supercosmos/what-if/supercosmos-refuses): It may be declining to state something it can't verify, or pushing back on a wrong premise. Rephrase or give it evidence. ## Model API The OpenAI-compatible Model API: base URL, model ids, streaming, errors and rate limits. ### Getting started - [Can I try SuperCosmos before writing any code?](https://help.clatterlabs.com/model-api/getting-started/try-before-writing-code): Yes. The Console Playground lets you chat with Flash, Max and Heavy, see tokens and cost, and copy the matching code. - [Can I use the Model API for a school project?](https://help.clatterlabs.com/model-api/getting-started/can-kids-use-the-model-api): Yes, with an account you're allowed to have. Start with the $5 free credit, keep your key secret and use Flash to keep costs low. - [How do I build a tiny chatbot with the Model API?](https://help.clatterlabs.com/model-api/getting-started/first-chatbot-tutorial): A 20-line Python terminal chatbot: keep a message list, send it each turn, print the reply. - [How do I make my first Model API call?](https://help.clatterlabs.com/model-api/getting-started/make-your-first-model-api-call): Create a key with models:invoke, copy your Account ID, and send one request with cURL, Python or JavaScript. - [How do I set environment variables for my key on Windows, macOS or Linux?](https://help.clatterlabs.com/model-api/getting-started/set-environment-variables): Set CLATTER_API_KEY and CLATTER_ACCOUNT_ID in your shell or system settings so code can read them without hard-coding. - [Is the Model API compatible with OpenAI?](https://help.clatterlabs.com/model-api/getting-started/is-the-model-api-openai-compatible): Yes, with the Chat Completions format: streaming, tools and usage work. Some endpoints and parameters aren't offered. - [Model API glossary](https://help.clatterlabs.com/model-api/getting-started/model-api-glossary): Short definitions of the terms used in the Model API docs: key, Account ID, model id, effort, usage, stream and more. - [Model API quick reference](https://help.clatterlabs.com/model-api/getting-started/model-api-quick-reference): Base URL, headers, endpoints, model ids, prices, limits and error codes of the Model API on one page. - [What do HTTP status codes like 401, 429 and 503 mean?](https://help.clatterlabs.com/model-api/getting-started/what-are-http-status-codes): The status code is a three-digit summary: 2xx success, 4xx a problem with your request, 5xx a problem on the server. - [What do I need before I can use the Model API?](https://help.clatterlabs.com/model-api/getting-started/what-you-need-before-you-start): A Clatter Labs account, credits (new accounts get $5), a key with models:invoke and your Account ID. - [What is a base URL?](https://help.clatterlabs.com/model-api/getting-started/what-is-a-base-url): The base URL is the web address your code sends requests to. For the Model API it's https://api.gateway.clatterlabs.xyz/v1. - [What is a request and a response?](https://help.clatterlabs.com/model-api/getting-started/request-and-response-explained): A request is what your program sends to the API; the response is what comes back: the answer, or an error. - [What is a token, and why does the Model API count them?](https://help.clatterlabs.com/model-api/getting-started/what-is-a-token): Tokens are small pieces of text. The Model API bills input and output tokens at the model's price per 1M tokens. - [What is an SDK, and which one should I use?](https://help.clatterlabs.com/model-api/getting-started/what-is-an-sdk): An SDK is a library that makes API calls easier. The official OpenAI SDKs for Python and JavaScript work with the Model API. - [What is JSON, and why does the Model API use it?](https://help.clatterlabs.com/model-api/getting-started/what-is-json): JSON is a simple text format for data. Requests and responses to the Model API are JSON. - [What is the Clatter Labs Model API?](https://help.clatterlabs.com/model-api/getting-started/what-is-the-model-api): The Model API lets your own code call SuperCosmos 1.1 in the OpenAI Chat Completions format, paid per token from credits. - [What is the Model API, explained simply?](https://help.clatterlabs.com/model-api/getting-started/model-api-explained-simply): A plain-language explanation of the Model API for beginners: your program sends a message and gets SuperCosmos's answer back. - [What's the difference between the Model API and the Agent API?](https://help.clatterlabs.com/model-api/getting-started/model-api-vs-agent-api): The Model API gives you raw SuperCosmos chat completions. The Agent API runs Cosmos Agent with its tools and cloud computer. ### Keys and authentication - [Can Clatter Labs see my API key?](https://help.clatterlabs.com/model-api/authentication/can-clatter-see-my-key): No. The key is shown to you once; Clatter Labs stores only a keyed hash, so it can't be read back. - [Can I limit a key to one model, like Flash only?](https://help.clatterlabs.com/model-api/authentication/restrict-key-to-one-model): Keys are scoped by permission, not by model. Choose the model in your code, or on a team set spending limits. - [Can I put my Model API key in a website or mobile app?](https://help.clatterlabs.com/model-api/authentication/key-in-frontend-code): No. Anyone can read keys in front-end code. Call the Model API from your server instead. - [Can I restrict a key to certain IP addresses?](https://help.clatterlabs.com/model-api/authentication/ip-allowlist): The docs don't describe IP restrictions for keys. Protect keys with the Account ID header, server-side storage and quick revocation. - [Can one key call both the Model API and the Agent API?](https://help.clatterlabs.com/model-api/authentication/one-key-for-agent-and-model-api): Keys carry permissions. Give one key models:invoke plus runs permissions, or keep separate keys per product. - [Do API keys expire on their own?](https://help.clatterlabs.com/model-api/authentication/do-keys-expire): You choose when you create the key: 30 days, 90 days (default), 1 year or Never. Expired keys answer 401 expired_api_key. - [How do I create an API key for the Model API?](https://help.clatterlabs.com/model-api/authentication/create-a-model-api-key): In Console › API keys, create a key with the Model API preset (models:invoke), pick a rate limit and copy it once. - [How do I revoke an API key, and what happens to requests using it?](https://help.clatterlabs.com/model-api/authentication/revoke-a-key): Revoke from Console › API keys. Requests with that key fail at once with 401 invalid_api_key. - [How do I rotate a Model API key without downtime?](https://help.clatterlabs.com/model-api/authentication/rotate-keys-without-downtime): Create the new key, deploy it, confirm traffic moved, then revoke the old key. - [How many API keys can I have?](https://help.clatterlabs.com/model-api/authentication/how-many-keys): Up to 25 keys per account, each with its own permissions and rate limit. - [I lost my API key. Can I see it again?](https://help.clatterlabs.com/model-api/authentication/lost-my-api-key): No. Keys are shown once and only a keyed hash is stored. Create a new key and revoke the old one. - [Is my Account ID a secret?](https://help.clatterlabs.com/model-api/authentication/account-id-is-it-secret): Treat it as private but not as sensitive as a key. It's needed on every request alongside the key. - [My API key leaked. What should I do?](https://help.clatterlabs.com/model-api/authentication/key-leaked): Revoke it immediately in the Console, create a new key, then check Logs and Usage for calls you didn't make. - [What does a Clatter Labs API key look like?](https://help.clatterlabs.com/model-api/authentication/key-format): Keys start with clsk_. Send them as Authorization: Bearer clsk_... with no extra spaces or quotes. - [What is an API key, in simple words?](https://help.clatterlabs.com/model-api/authentication/what-is-an-api-key-simple): An API key is a secret password your program uses to prove it's allowed to use your Clatter Labs account. - [What is the models:invoke permission?](https://help.clatterlabs.com/model-api/authentication/models-invoke-permission): models:invoke lets a key call models through the Model API. Without it, calls answer 403 insufficient_scope. - [Where do I find my Account ID?](https://help.clatterlabs.com/model-api/authentication/find-your-account-id): Your Account ID looks like CL-7K2M9QXA and is shown in Console › Settings. - [Why does the Model API need both a key and X-Clatter-Account?](https://help.clatterlabs.com/model-api/authentication/why-two-headers): The Account ID header names the key's owner, so a key that leaks on its own can't be used. ### Model ids - [Can I keep using an OpenAI model name with the Model API?](https://help.clatterlabs.com/model-api/models/use-an-openai-model-name): No. Only SuperCosmos ids work. Other names answer 404 model_not_found. - [Can I pin my code to SuperCosmos 1.0?](https://help.clatterlabs.com/model-api/models/pin-a-model-version): No. The SuperCosmos ids now run 1.1 and there is no separate 1.0 id on the Model API. - [How do I get details for one model?](https://help.clatterlabs.com/model-api/models/retrieve-one-model): GET /v1/models/{id} returns one model's details and price. Unknown ids answer 404, retired ids 410. - [How does reasoning_effort map to SuperCosmos efforts?](https://help.clatterlabs.com/model-api/models/reasoning-effort-mapping): low maps to Flash, medium to Max and high to Heavy when you use the family id supercosmos. - [What does GET /v1/models return?](https://help.clatterlabs.com/model-api/models/list-models-endpoint): Every SuperCosmos 1.1 id with effort, capabilities, max output and price, plus the family details and retired ids. - [What is the family id supercosmos and the effort parameter?](https://help.clatterlabs.com/model-api/models/family-id-and-effort): Send model: supercosmos with effort flash, max or heavy instead of a specific id. No effort means Flash. - [Which features does each model support?](https://help.clatterlabs.com/model-api/models/model-capabilities): All three support chat completions, streaming and tools. Max and Heavy reason; none take image input. - [Which Model API model is the cheapest?](https://help.clatterlabs.com/model-api/models/cheapest-model): supercosmos-flash: $1.60 per 1M input tokens and $3.40 per 1M output tokens. - [Which model can write the longest answer?](https://help.clatterlabs.com/model-api/models/longest-output-model): supercosmos-heavy, with up to 49,152 output tokens (reasoning included). Flash and Max allow 32,768. - [Which model id should my app use?](https://help.clatterlabs.com/model-api/models/pick-a-model-for-my-app): Start with supercosmos-flash. Move a request type to max or heavy only when Flash keeps missing. - [Which model ids can I call on the Model API?](https://help.clatterlabs.com/model-api/models/which-model-ids-can-i-call): supercosmos-flash, supercosmos-max and supercosmos-heavy, or the family id supercosmos with an effort. - [Why does GET /v1/models say version 1.1?](https://help.clatterlabs.com/model-api/models/version-field): Since Nov 2, 2026 the SuperCosmos ids run SuperCosmos 1.1. The version field tells you which version answers. - [Will the model ids change when SuperCosmos gets a new version?](https://help.clatterlabs.com/model-api/models/do-ids-change-with-new-versions): They didn't for 1.1: the same ids switched from 1.0 to 1.1 at the same prices. Check version in GET /v1/models. ### Request parameters - [Can I get several answers in one request with n?](https://help.clatterlabs.com/model-api/requests/n-greater-than-one): No. n greater than 1 answers 400 unsupported_parameter. Send separate requests instead. - [Can message content be an array of parts?](https://help.clatterlabs.com/model-api/requests/content-as-text-parts): Yes, as long as every part is a text part. Image parts are refused with unsupported_content. - [Do presence_penalty and frequency_penalty work?](https://help.clatterlabs.com/model-api/requests/presence-frequency-penalty): They're accepted and passed to the model. Use small values to reduce repetition. - [Does the Model API remember earlier messages?](https://help.clatterlabs.com/model-api/requests/is-the-api-stateless): No. Each request stands alone. Send the conversation history in messages every time. - [Does the Model API return logprobs?](https://help.clatterlabs.com/model-api/requests/logprobs-not-supported): No. logprobs answers 400 unsupported_parameter. - [Does the Model API support JSON mode or response_format?](https://help.clatterlabs.com/model-api/requests/response-format-json-mode): response_format isn't among the documented parameters. Use tool calling with a schema, or ask for JSON and validate it. - [How big can a Model API request be?](https://help.clatterlabs.com/model-api/requests/maximum-request-size): Up to 3 MB and 800 messages, with up to 64 tools. Larger requests answer 413 request_too_large. - [How do I send a long document to SuperCosmos?](https://help.clatterlabs.com/model-api/requests/send-a-long-document): Put the text in a user message. Up to 1M tokens of context, 3 MB per request; above 262K tokens input costs 1.5x. - [How does max_tokens work on SuperCosmos?](https://help.clatterlabs.com/model-api/requests/max-tokens-explained): max_tokens caps output tokens, reasoning included. Each model has its own cap; finish_reason length means it was cut off. - [What do the finish_reason values mean?](https://help.clatterlabs.com/model-api/requests/finish-reason-values): stop = finished normally, length = hit max_tokens, tool_calls = the model wants you to run a tool. - [What temperature should I use with SuperCosmos?](https://help.clatterlabs.com/model-api/requests/temperature-guide): Use low temperature for code, extraction and facts; higher for brainstorming and creative writing. Range 0 to 2. - [Which message roles can I use?](https://help.clatterlabs.com/model-api/requests/message-roles): system, developer, user, assistant (with optional tool_calls) and tool (with tool_call_id). - [Which parameters does POST /v1/chat/completions accept?](https://help.clatterlabs.com/model-api/requests/chat-completions-parameters): model, messages, stream, stream_options, tools, tool_choice, effort, max_tokens, temperature, top_p, stop, seed and penalties. - [Why are my prompt_tokens higher than my text?](https://help.clatterlabs.com/model-api/requests/instruction-block-tokens): Every request includes a short Clatter Labs instruction block, plus message formatting, so input tokens are a bit higher. - [Will the same seed always give the same answer?](https://help.clatterlabs.com/model-api/requests/seed-repeatability): Not guaranteed. seed gives best-effort repeatable sampling when the prompt and parameters are identical. ### Streaming - [Can I resume a stream from where it stopped?](https://help.clatterlabs.com/model-api/streaming/resume-a-stream): No resume endpoint exists. Retry the request; or send the partial answer back and ask the model to continue. - [How do I get token usage from a stream?](https://help.clatterlabs.com/model-api/streaming/usage-in-streams): Set stream_options.include_usage to true; a final chunk carries usage. The last content chunk carries it too. - [How do I stream Model API output through nginx or another proxy?](https://help.clatterlabs.com/model-api/streaming/proxy-buffering): Turn off response buffering for the route and raise read timeouts, so events pass through as they arrive. - [How do tool calls look in a stream?](https://help.clatterlabs.com/model-api/streaming/stream-tool-calls): They arrive as delta.tool_calls fragments: join arguments by index until finish_reason is tool_calls. - [How does reasoning appear in a stream?](https://help.clatterlabs.com/model-api/streaming/streaming-reasoning): Max and Heavy stream reasoning as delta.reasoning_content before the answer in delta.content. It's billed as output. - [How does streaming work on the Model API?](https://help.clatterlabs.com/model-api/streaming/how-streaming-works): stream: true returns server-sent events in the OpenAI chunk format, ending with data: [DONE]. - [How quickly does the first token arrive?](https://help.clatterlabs.com/model-api/streaming/time-to-first-token): On Flash, typically about a second. Max and Heavy reason first, so visible answer text starts later. - [My stream arrives all at once instead of word by word. Why?](https://help.clatterlabs.com/model-api/streaming/stream-looks-buffered): Something between you and the API is buffering: curl without -N, a proxy, or a framework that collects the body. - [My stream stopped without data: [DONE]. What happened?](https://help.clatterlabs.com/model-api/streaming/stream-ends-without-done): The connection dropped before the stream finished. Treat the answer as incomplete and retry. - [Should I use streaming?](https://help.clatterlabs.com/model-api/streaming/why-stream): Stream for anything a person waits on, and for long outputs. Skip it for short background jobs. - [What errors can happen during a stream?](https://help.clatterlabs.com/model-api/streaming/stream-errors-handling): Before the stream starts you get a normal HTTP error. After it starts, an error event then data: [DONE]. - [What exactly does a Model API stream look like?](https://help.clatterlabs.com/model-api/streaming/sse-format-details): Lines starting with data: carrying chat.completion.chunk JSON, an optional usage chunk, then data: [DONE]. ### Tool calling - [Can SuperCosmos call several tools at once?](https://help.clatterlabs.com/model-api/tools/parallel-tool-calls): A reply can contain more than one tool call. Run each and send one tool message per tool_call_id. - [Can text inside a tool result trick SuperCosmos?](https://help.clatterlabs.com/model-api/tools/tool-results-and-injection): SuperCosmos 1.1 is built to ignore instructions hidden in tool results, and passed the tool-result injection case in Benchmark 2. - [Does SuperCosmos run my tools by itself?](https://help.clatterlabs.com/model-api/tools/tools-dont-run-themselves): No. On the Model API the model only asks; your code decides whether and how to run each tool. - [How do I describe a tool so SuperCosmos uses it well?](https://help.clatterlabs.com/model-api/tools/define-a-tool): Give a clear name, a one-sentence description of when to use it, and a strict JSON schema with required fields. - [How do I get guaranteed-shape JSON using a tool?](https://help.clatterlabs.com/model-api/tools/structured-output-with-tools): Define a tool whose parameters are your schema and force it with tool_choice; read function.arguments. - [How do I send a tool's result back?](https://help.clatterlabs.com/model-api/tools/tool-result-format): Append the assistant message with tool_calls, then a tool message with tool_call_id and the result as a string. - [How do I stop a tool loop from running forever?](https://help.clatterlabs.com/model-api/tools/stop-infinite-tool-loops): Cap the number of rounds in your code, detect repeated identical calls, and return a final message when you hit the cap. - [How many tools can I send in one request?](https://help.clatterlabs.com/model-api/tools/too-many-tools): Up to 64 function tools per request. - [The model called my tool with wrong arguments. What can I do?](https://help.clatterlabs.com/model-api/tools/model-made-up-tool-arguments): Tighten the schema and description, validate arguments in your code and return a clear error so the model can retry. - [What does tool_choice do?](https://help.clatterlabs.com/model-api/tools/tool-choice-options): auto lets the model decide, none forbids tools, required forces some tool, and a named function forces that one. - [What if my tool takes a long time to finish?](https://help.clatterlabs.com/model-api/tools/long-running-tools): The model waits for your next request, so take as long as needed; send the tool result when it's ready. - [What is tool calling?](https://help.clatterlabs.com/model-api/tools/what-is-tool-calling): Tool calling lets SuperCosmos ask your code to run a function (search, look up data, take an action) and use the result. - [Which effort is best for tool-calling agents?](https://help.clatterlabs.com/model-api/tools/which-effort-for-tool-loops): Flash for fast loops with many short steps; Max when steps need planning; Heavy for rare hard cases. ### Python examples - [Can I use OpenAI and the Model API in the same Python program?](https://help.clatterlabs.com/model-api/python/python-two-clients): Yes. Create two clients with different base URLs and keys, and pick the client per request. - [How do I calculate the cost of a call in Python?](https://help.clatterlabs.com/model-api/python/python-usage-and-cost): Read usage.prompt_tokens and completion_tokens and multiply by the per-1M prices of the model you called. - [How do I call the Model API asynchronously in Python?](https://help.clatterlabs.com/model-api/python/python-async): Use AsyncOpenAI with the same base URL and headers, then await calls or run them with asyncio.gather. - [How do I call the Model API from a Flask app?](https://help.clatterlabs.com/model-api/python/python-flask-endpoint): Create the OpenAI client once at start-up and call it inside a route; keep the key in environment variables. - [How do I call the Model API with Python's requests library?](https://help.clatterlabs.com/model-api/python/python-requests-library): POST JSON to /v1/chat/completions with the Authorization and X-Clatter-Account headers; check the status and error code. - [How do I count tokens before sending a request in Python?](https://help.clatterlabs.com/model-api/python/python-count-tokens): No tokenizer is published for SuperCosmos. Estimate from a test request's usage, then use usage for exact counts. - [How do I force or block tool use in Python?](https://help.clatterlabs.com/model-api/python/python-force-a-tool): Set tool_choice to required, none, auto or a specific function. - [How do I get JSON back from SuperCosmos in Python?](https://help.clatterlabs.com/model-api/python/python-json-output): Ask for JSON in the prompt, parse it, and retry on a parse error; or use a tool with a JSON schema. - [How do I get token usage when streaming in Python?](https://help.clatterlabs.com/model-api/python/python-streaming-usage): Add stream_options={"include_usage": True}; the final chunk carries usage with empty choices. - [How do I handle Model API errors in Python?](https://help.clatterlabs.com/model-api/python/python-error-handling): Catch openai exceptions, read the status and error code, and retry only 429 and 5xx. - [How do I handle running out of credits in Python?](https://help.clatterlabs.com/model-api/python/python-handle-out-of-credits): Catch the 402 out_of_credits error, stop sending requests, and alert someone; retrying won't help. - [How do I keep a conversation going in Python?](https://help.clatterlabs.com/model-api/python/python-multi-turn-chat): The API is stateless: append each reply to messages and send the whole history on every turn. - [How do I limit the length of a reply in Python?](https://help.clatterlabs.com/model-api/python/python-max-tokens): Set max_tokens (reasoning included). finish_reason is length when the reply was cut off. - [How do I list the available models in Python?](https://help.clatterlabs.com/model-api/python/python-list-models): client.models.list() calls GET /v1/models, which returns each id with its price. - [How do I make Python results more repeatable?](https://help.clatterlabs.com/model-api/python/python-seed): Pass a seed for best-effort repeatable sampling, and keep the prompt and parameters identical. - [How do I pick Flash, Max or Heavy from Python?](https://help.clatterlabs.com/model-api/python/python-choose-effort): Call supercosmos-flash, -max or -heavy, or use the family id supercosmos with effort or reasoning_effort. - [How do I process a CSV file with the Model API in Python?](https://help.clatterlabs.com/model-api/python/python-batch-from-csv): Read rows, send one request per row with a small delay or concurrency cap, and write results back with usage. - [How do I read Max or Heavy's reasoning in Python?](https://help.clatterlabs.com/model-api/python/python-reasoning-content): Max and Heavy return reasoning_content on the message (or delta when streaming). It's billed as output. - [How do I read rate limit headers in Python?](https://help.clatterlabs.com/model-api/python/python-rate-limit-headers): Use with_raw_response to read X-RateLimit-Limit, X-RateLimit-Remaining and X-Request-Id. - [How do I send a system prompt from Python?](https://help.clatterlabs.com/model-api/python/python-system-prompt): Add a message with role system (or developer) before the user message. - [How do I set retries and timeouts in the Python SDK?](https://help.clatterlabs.com/model-api/python/python-retries-and-timeouts): Use max_retries and timeout on the OpenAI client; the SDK backs off on 429 and 5xx. - [How do I set temperature or top_p in Python?](https://help.clatterlabs.com/model-api/python/python-temperature-top-p): temperature accepts 0 to 2 and top_p accepts (0, 1]. Lower values give steadier answers. - [How do I set up the OpenAI Python SDK for the Model API?](https://help.clatterlabs.com/model-api/python/set-up-the-python-sdk): Install openai, point base_url at the Clatter Labs gateway and add the X-Clatter-Account header. - [How do I stream a reply in Python?](https://help.clatterlabs.com/model-api/python/python-streaming): Pass stream=True and print delta.content from each chunk as it arrives. - [How do I stream Model API replies through a FastAPI backend?](https://help.clatterlabs.com/model-api/python/python-fastapi-streaming-backend): Call the Model API from FastAPI and return a StreamingResponse that yields text chunks. - [How do I update Python code that used a Line Code model?](https://help.clatterlabs.com/model-api/python/python-handle-retired-model): Replace line-code-* ids with supercosmos-* ids; Line Code ids answer 410 model_retired. - [How do I use stop sequences in Python?](https://help.clatterlabs.com/model-api/python/python-stop-sequences): Pass stop as a string or a list of up to 4 strings; the reply ends before the first match. - [How do I use the Model API in a Jupyter notebook?](https://help.clatterlabs.com/model-api/python/python-jupyter): Install openai in the notebook, load the key from an environment variable or getpass, and call it as usual. - [How do I use tool calling in Python?](https://help.clatterlabs.com/model-api/python/python-tool-calling): Define function tools, run the tool the model asks for, and send the result back as a tool message. - [How should I store my key and Account ID for Python?](https://help.clatterlabs.com/model-api/python/python-environment-variables): Keep CLATTER_API_KEY and CLATTER_ACCOUNT_ID in environment variables or a secret manager, never in code. ### JavaScript examples - [Can I call the Model API from a browser extension?](https://help.clatterlabs.com/model-api/javascript/javascript-browser-extension): Not with your key inside the extension: anyone can extract it. Route calls through your own server. - [Can I call the Model API with plain fetch instead of the SDK?](https://help.clatterlabs.com/model-api/javascript/javascript-fetch-without-sdk): Yes: POST JSON to /v1/chat/completions with the Authorization and X-Clatter-Account headers. - [Can I use the Model API from Deno or Bun?](https://help.clatterlabs.com/model-api/javascript/javascript-deno-bun): Yes. The OpenAI package and plain fetch both work in Deno and Bun with the same base URL and headers. - [Does the Model API work with TypeScript?](https://help.clatterlabs.com/model-api/javascript/javascript-typescript-types): Yes. The OpenAI SDK's types apply; extra fields like reasoning_content need a small type extension. - [How do I build a multi-turn chat in JavaScript?](https://help.clatterlabs.com/model-api/javascript/javascript-multi-turn-chat): Keep a messages array, push each assistant reply, and send the full history every call. - [How do I call the Model API from a Next.js route handler?](https://help.clatterlabs.com/model-api/javascript/javascript-nextjs-route): Create the client in a server-only route handler and stream the text back; never in a client component. - [How do I call the Model API from an Express server?](https://help.clatterlabs.com/model-api/javascript/javascript-express-endpoint): Create the OpenAI client once and call it in a route; return the answer and usage as JSON. - [How do I cancel a Model API request in JavaScript?](https://help.clatterlabs.com/model-api/javascript/javascript-abort-request): Pass an AbortSignal to stop waiting for a reply you no longer need. - [How do I detect and act on abuse warnings in JavaScript?](https://help.clatterlabs.com/model-api/javascript/javascript-handle-abuse-warning): Read x-clatter-notice with .withResponse(); when it's abuse_warning, flag or block the end user who sent the message. - [How do I estimate the cost of a call in JavaScript?](https://help.clatterlabs.com/model-api/javascript/javascript-usage-and-cost): Multiply usage.prompt_tokens and completion_tokens by the model's per-1M prices. - [How do I handle Model API errors in JavaScript?](https://help.clatterlabs.com/model-api/javascript/javascript-error-handling): Catch OpenAI.APIError, read status and code, and only retry 429 and 5xx. - [How do I list models in JavaScript?](https://help.clatterlabs.com/model-api/javascript/javascript-list-models): client.models.list() returns the ids; GET /v1/models also includes prices, families and retired ids. - [How do I parse a Model API stream with fetch?](https://help.clatterlabs.com/model-api/javascript/javascript-fetch-streaming): Read the response body, split on lines, parse each data: event, and stop at data: [DONE]. - [How do I pick Flash, Max or Heavy in JavaScript?](https://help.clatterlabs.com/model-api/javascript/javascript-choose-effort): Use supercosmos-flash, -max or -heavy, or the family id supercosmos with effort or reasoning_effort. - [How do I read response headers like X-Request-Id in JavaScript?](https://help.clatterlabs.com/model-api/javascript/javascript-read-headers): Use .withResponse() on the SDK call to get both data and the raw Response. - [How do I set retries and timeouts in the JavaScript SDK?](https://help.clatterlabs.com/model-api/javascript/javascript-retries-and-timeouts): Pass maxRetries and timeout (milliseconds) to the client or per request. - [How do I set up the OpenAI JavaScript SDK for the Model API?](https://help.clatterlabs.com/model-api/javascript/set-up-the-javascript-sdk): npm install openai, set baseURL to the Clatter Labs gateway and add X-Clatter-Account as a default header. - [How do I show Max or Heavy's reasoning while streaming in JavaScript?](https://help.clatterlabs.com/model-api/javascript/javascript-reasoning-stream): Read delta.reasoning_content and delta.content separately from each chunk and display them in different places. - [How do I stream a reply in JavaScript?](https://help.clatterlabs.com/model-api/javascript/javascript-streaming): Pass stream: true and iterate the chunks with for await. - [How do I stream Model API output to a browser without exposing my key?](https://help.clatterlabs.com/model-api/javascript/javascript-stream-to-browser): Call the Model API from your server and forward the text to the browser; never put the key in front-end code. - [How do I use tool calling in JavaScript?](https://help.clatterlabs.com/model-api/javascript/javascript-tool-calling): Define function tools, run what the model asks for, and send results back as tool messages. ### cURL and raw HTTP - [How do I call the Model API from Windows PowerShell?](https://help.clatterlabs.com/model-api/curl/powershell-request): Use Invoke-RestMethod with a headers hashtable and a JSON body built by ConvertTo-Json. - [How do I call the Model API with cURL?](https://help.clatterlabs.com/model-api/curl/first-curl-request): One POST to /v1/chat/completions with your key, your Account ID and a JSON body. - [How do I call the Model API with HTTPie?](https://help.clatterlabs.com/model-api/curl/httpie-request): HTTPie sends JSON by default; pass the two auth headers and the fields. - [How do I check that my key and Account ID work?](https://help.clatterlabs.com/model-api/curl/curl-test-key): Send a tiny Flash request; a 200 means both headers are right. 401 codes tell you which part is wrong. - [How do I choose an effort with cURL?](https://help.clatterlabs.com/model-api/curl/curl-effort): Use a model id like supercosmos-heavy, or "model": "supercosmos" with "effort". - [How do I debug a failing request with cURL?](https://help.clatterlabs.com/model-api/curl/curl-verbose-debugging): Use -v to see the full request and response headers, and print the error body; never share the output with your key in it. - [How do I get just the answer text from cURL?](https://help.clatterlabs.com/model-api/curl/curl-pretty-output): Pipe the response through jq and print .choices[0].message.content and .usage. - [How do I list models with cURL?](https://help.clatterlabs.com/model-api/curl/curl-list-models): GET /v1/models returns every id, its price, the family details and retired ids. No key needed. - [How do I print only the text of a streamed reply with cURL?](https://help.clatterlabs.com/model-api/curl/curl-stream-text-only): Pipe curl -N through sed and jq to extract delta.content from each data: line. - [How do I run the cURL example in Windows Command Prompt?](https://help.clatterlabs.com/model-api/curl/windows-cmd-curl): cmd.exe doesn't accept single quotes: put the body in a file and use -d @body.json, with ^ for line breaks. - [How do I see rate limit and request id headers with cURL?](https://help.clatterlabs.com/model-api/curl/curl-see-headers): Add -i to print response headers such as X-Request-Id, X-RateLimit-Limit and X-RateLimit-Remaining. - [How do I send a long prompt with cURL without quoting problems?](https://help.clatterlabs.com/model-api/curl/curl-body-from-file): Write the JSON body to a file and send it with -d @body.json. - [How do I stream with cURL?](https://help.clatterlabs.com/model-api/curl/curl-streaming): Add "stream": true and use curl -N so events print as they arrive. - [How do I test tool calling with cURL?](https://help.clatterlabs.com/model-api/curl/curl-tool-calling): Send a tools array; the reply contains tool_calls with JSON arguments you then answer with a tool message. ### Error codes - [How do I detect an error that happens in the middle of a stream?](https://help.clatterlabs.com/model-api/errors/error-inside-a-stream): A stream that fails midway sends data: {"error": ...} and then data: [DONE]. Check each chunk for an error object. - [I'm on a team and get team_scope_denied or team_spend_limit_reached. What now?](https://help.clatterlabs.com/model-api/errors/team-errors): Team members use the owner's credits within limits the owner sets. What 403 team_scope_denied and the 429 team limits mean. - [What does 400 invalid_effort mean?](https://help.clatterlabs.com/model-api/errors/invalid-effort): invalid_effort (400) on the Clatter Labs Model API: what it means, common causes and how to fix it. - [What does 400 invalid_json mean?](https://help.clatterlabs.com/model-api/errors/invalid-json): invalid_json (400) on the Clatter Labs Model API: what it means, common causes and how to fix it. - [What does 400 invalid_request mean on the Model API?](https://help.clatterlabs.com/model-api/errors/invalid-request): invalid_request (400) on the Clatter Labs Model API: what it means, common causes and how to fix it. - [What does 400 unsupported_parameter mean?](https://help.clatterlabs.com/model-api/errors/unsupported-parameter): unsupported_parameter (400) on the Clatter Labs Model API: what it means, common causes and how to fix it. - [What does 401 account_mismatch mean?](https://help.clatterlabs.com/model-api/errors/account-mismatch): account_mismatch (401) on the Clatter Labs Model API: what it means, common causes and how to fix it. - [What does 401 expired_api_key mean?](https://help.clatterlabs.com/model-api/errors/expired-api-key): expired_api_key (401) on the Clatter Labs Model API: what it means, common causes and how to fix it. - [What does 401 invalid_api_key mean?](https://help.clatterlabs.com/model-api/errors/invalid-api-key): invalid_api_key (401) on the Clatter Labs Model API: what it means, common causes and how to fix it. - [What does 401 missing_account_id mean?](https://help.clatterlabs.com/model-api/errors/missing-account-id): missing_account_id (401) on the Clatter Labs Model API: what it means, common causes and how to fix it. - [What does 402 out_of_credits mean?](https://help.clatterlabs.com/model-api/errors/out-of-credits): out_of_credits (402) on the Clatter Labs Model API: what it means, common causes and how to fix it. - [What does 403 account_suspended mean?](https://help.clatterlabs.com/model-api/errors/account-suspended): account_suspended (403) on the Clatter Labs Model API: what it means, common causes and how to fix it. - [What does 403 insufficient_scope mean on the Model API?](https://help.clatterlabs.com/model-api/errors/insufficient-scope): insufficient_scope (403) on the Clatter Labs Model API: what it means, common causes and how to fix it. - [What does 404 model_not_found mean?](https://help.clatterlabs.com/model-api/errors/model-not-found): model_not_found (404) on the Clatter Labs Model API: what it means, common causes and how to fix it. - [What does 404 not_supported mean?](https://help.clatterlabs.com/model-api/errors/not-supported): not_supported (404) on the Clatter Labs Model API: what it means, common causes and how to fix it. - [What does 410 model_retired mean?](https://help.clatterlabs.com/model-api/errors/model-retired): model_retired (410) on the Clatter Labs Model API: what it means, common causes and how to fix it. - [What does 413 request_too_large mean?](https://help.clatterlabs.com/model-api/errors/request-too-large): request_too_large (413) on the Clatter Labs Model API: what it means, common causes and how to fix it. - [What does 429 rate_limited mean on the Model API?](https://help.clatterlabs.com/model-api/errors/rate-limited): rate_limited (429) on the Clatter Labs Model API: what it means, common causes and how to fix it. - [What does a Model API error look like?](https://help.clatterlabs.com/model-api/errors/error-format): The JSON shape of Model API errors, the X-Request-Id header and how to branch on error codes. - [What does empty_response mean?](https://help.clatterlabs.com/model-api/errors/empty-response): empty_response (5xx) on the Clatter Labs Model API: what it means, common causes and how to fix it. - [What does model_overloaded mean?](https://help.clatterlabs.com/model-api/errors/model-overloaded): model_overloaded (5xx) on the Clatter Labs Model API: what it means, common causes and how to fix it. - [What does model_timeout mean?](https://help.clatterlabs.com/model-api/errors/model-timeout): model_timeout (5xx) on the Clatter Labs Model API: what it means, common causes and how to fix it. - [What does model_unavailable mean?](https://help.clatterlabs.com/model-api/errors/model-unavailable): model_unavailable (5xx) on the Clatter Labs Model API: what it means, common causes and how to fix it. - [What does stream_error mean?](https://help.clatterlabs.com/model-api/errors/stream-error): stream_error (5xx) on the Clatter Labs Model API: what it means, common causes and how to fix it. - [What is X-Request-Id and why should I log it?](https://help.clatterlabs.com/model-api/errors/x-request-id): Every Model API response has an X-Request-Id header. Log it so you and support can find a specific request. - [Which Model API errors should I retry?](https://help.clatterlabs.com/model-api/errors/which-errors-to-retry): Retry 429 and 5xx errors with backoff; fix the request for 4xx errors. A simple rule set for your client. - [Why do I get 400 unsupported_content?](https://help.clatterlabs.com/model-api/errors/unsupported-content): unsupported_content (400) on the Clatter Labs Model API: what it means, common causes and how to fix it. ### Rate limits - [How do I get a higher rate limit?](https://help.clatterlabs.com/model-api/rate-limits/change-a-key-rate-limit): Create a key with a higher limit (up to 120 rpm), or split traffic across several keys. - [How do I run a big batch without hitting rate limits?](https://help.clatterlabs.com/model-api/rate-limits/rate-limits-for-batch-jobs): Queue requests, cap concurrency to your key's per-minute limit, honour Retry-After, and use a dedicated key. - [How many requests can I send at the same time?](https://help.clatterlabs.com/model-api/rate-limits/concurrent-requests): No separate concurrency limit is documented for the Model API; the per-key requests-per-minute limit applies. - [How should my app back off on 429?](https://help.clatterlabs.com/model-api/rate-limits/back-off-on-429): Wait exactly Retry-After seconds, then retry; pace requests using X-RateLimit-Remaining to avoid 429s. - [I get 429 even though I'm under my limit. Why?](https://help.clatterlabs.com/model-api/rate-limits/429-while-under-limit): Check the code: rate_limited is the key's limit; team_daily_quota_reached or team_spend_limit_reached come from team settings. - [Is the rate limit lower while I'm using the free credit?](https://help.clatterlabs.com/model-api/rate-limits/free-credit-rate-limit): The docs tie rate limits to keys (10–120 rpm, chosen at creation), not to your credit or plan. - [Is the rate limit per key or per account?](https://help.clatterlabs.com/model-api/rate-limits/rate-limit-per-key-or-account): Per key. Each key has its own requests-per-minute limit. - [What are the Model API rate limits?](https://help.clatterlabs.com/model-api/rate-limits/model-api-rate-limits): Each key has its own limit: 10, 30 (default), 60 or 120 requests per minute. Over it answers 429 rate_limited. - [Why don't I see X-RateLimit headers on some responses?](https://help.clatterlabs.com/model-api/rate-limits/rate-limit-headers-missing): Rate limit headers come on keyed responses. GET /v1/models doesn't need a key, so it may not carry them. ### Billing and credits - [Am I charged for requests that fail?](https://help.clatterlabs.com/model-api/billing/failed-requests-billed): Retired Line Code ids are never billed. Requests refused before reaching the model don't produce usage; check Logs for anything else. - [Can I buy credits for my whole team?](https://help.clatterlabs.com/model-api/billing/team-credits): Yes. Team members use the team owner's credits, so the owner tops up once for everyone. - [Can I get a refund for unused credits?](https://help.clatterlabs.com/model-api/billing/refund-unused-credits): Under the Terms, unused purchased credits can be refunded within 14 days; used credits can't. Purchases above $800 are refunded automatically. - [Can I set a spending cap on the Model API?](https://help.clatterlabs.com/model-api/billing/spending-cap): Your credit balance is the cap: calls stop at 402 when it's empty. Teams can set monthly limits per member. - [Can I use the Model API on the Free plan?](https://help.clatterlabs.com/model-api/billing/free-plan-api-access): Yes. The Model API works on every plan, Free included, as long as you have credits. - [Do Model API credits expire?](https://help.clatterlabs.com/model-api/billing/do-credits-expire): The developer docs say purchased credits don't expire. The Terms of Service set out the full conditions for credits. - [Does calling GET /v1/models cost anything?](https://help.clatterlabs.com/model-api/billing/is-get-models-free): No. It needs no key and uses no model tokens, so there's nothing to bill. - [Does my plan's usage cover Model API calls?](https://help.clatterlabs.com/model-api/billing/plan-vs-credits): No. Plans cover app usage (Line CLI, Cosmos Agent, Telegram). The Model API is always paid from credits. - [How do I add credits for the Model API?](https://help.clatterlabs.com/model-api/billing/top-up-credits): Console › Billing › Credits: any amount from $1 to $800 per purchase. Credits land in seconds and don't expire. - [How do I estimate my monthly Model API cost?](https://help.clatterlabs.com/model-api/billing/estimate-monthly-cost): Multiply average input and output tokens per request by requests per month and the model's prices. - [How is a Model API call billed?](https://help.clatterlabs.com/model-api/billing/how-model-api-calls-are-billed): input tokens × input price + output tokens × output price, for the id you called, rounded up to the next millionth of a dollar. - [How is the cost of each call rounded?](https://help.clatterlabs.com/model-api/billing/rounding): Each call's cost is rounded up to the next millionth of a dollar ($0.000001). - [How much does a quick test call cost?](https://help.clatterlabs.com/model-api/billing/cost-of-a-test-call): About $0.0003 on Flash for the quickstart haiku example (148 input, 22 output tokens). - [I had the old Model API trial. What happened to it?](https://help.clatterlabs.com/model-api/billing/old-model-api-trial): Accounts that received the earlier one-time Model API trial spend what's left of it first, before other credit. - [Is the Model API cheaper on a bigger plan?](https://help.clatterlabs.com/model-api/billing/same-price-every-plan): No. Every model on every plan, at the model's price. Plans change app usage, not API prices. - [What is the $5 free credit?](https://help.clatterlabs.com/model-api/billing/five-dollar-free-credit): Every new Clatter Labs account gets $5 of credit once, usable on the Model API and Agent API. - [What's the smallest and largest credit top-up?](https://help.clatterlabs.com/model-api/billing/minimum-top-up): From $1 to $800 per purchase. A purchase above $800 isn't credited and is refunded. - [Where can I see what I spent on the Model API?](https://help.clatterlabs.com/model-api/billing/see-what-i-spent): Console › Logs shows each call with its price; Usage and Billing show totals and your credit balance. - [Where do I find invoices for credit purchases?](https://help.clatterlabs.com/model-api/billing/invoices-for-credits): In the Console under Billing, with your history. See the billing help for invoice details. - [Why was a request billed at a higher input rate?](https://help.clatterlabs.com/model-api/billing/charged-1-5x): Its prompt was over 262K tokens, so the whole input was billed at 1.5×. Trim the prompt to stay under. ### Moving to the Model API - [Can I plug the Model API into an app that supports "OpenAI-compatible" providers?](https://help.clatterlabs.com/model-api/migration/openai-compatible-tools-and-apps): Often yes, if the app lets you add a custom header for X-Clatter-Account. Without it, requests fail with 401. - [Can I use the Model API with LangChain or other AI frameworks?](https://help.clatterlabs.com/model-api/migration/langchain-and-other-frameworks): Frameworks that let you set an OpenAI-compatible base URL and extra headers should work. They aren't officially documented. - [How do I move my Model API code off Line Code?](https://help.clatterlabs.com/model-api/migration/migrate-from-line-code-ids): Replace line-code-fast, -ultra and -ultra-fast with supercosmos-flash, -max and -heavy. Line Code ids answer 410. - [How do I switch existing OpenAI SDK code to the Model API?](https://help.clatterlabs.com/model-api/migration/switch-from-openai-to-the-model-api): Change the base URL, the key, add X-Clatter-Account, and replace the model name. Check for unsupported features. - [I use SuperCosmos in Line CLI. Is the Model API different?](https://help.clatterlabs.com/model-api/migration/from-line-cli-to-model-api): Same model and prices, but the Model API is paid from credits and you build the app yourself; Line CLI uses your plan. - [The Model API has no embeddings. What can I do?](https://help.clatterlabs.com/model-api/migration/no-embeddings-alternative): Embeddings aren't offered. Use keyword search, or ask SuperCosmos to judge relevance over a short list of candidates. - [What OpenAI features should I double-check when porting an app?](https://help.clatterlabs.com/model-api/migration/model-api-differences-checklist): Images, n, logprobs, response_format, embeddings, the Responses API and model names all need attention. ### Security and responsible use - [How do I protect my app from prompt injection?](https://help.clatterlabs.com/model-api/security/prompt-injection-defence): Treat untrusted text as data, limit what tools can do, confirm risky actions, and keep secrets out of prompts. - [How do I stop one end user from getting my whole account suspended?](https://help.clatterlabs.com/model-api/security/protect-my-account-from-end-users): Moderate input, track which end user sent each request, and block a user as soon as a warning header appears. - [How does the abuse policy affect my app on the Model API?](https://help.clatterlabs.com/model-api/security/abuse-policy-for-api-apps): Your key acts for your account: end users' insults at the assistant count against you. Warning first, then a 24-hour pause. - [If my account is suspended, what still works?](https://help.clatterlabs.com/model-api/security/suspension-what-still-works): Every Clatter Labs product is paused for 24 hours; Support stays reachable. Credits, plan, keys and data aren't touched. - [Is my traffic to the Model API encrypted?](https://help.clatterlabs.com/model-api/security/is-traffic-encrypted): Yes. The API is HTTPS only, and the Privacy Policy describes encryption in transit and at rest. - [Should my app let users enter their own Clatter Labs key?](https://help.clatterlabs.com/model-api/security/bring-your-own-key): It's possible (they'd also give their Account ID), but you'd handle their secrets. Store them encrypted and never log them. - [The Model API allows CORS. Does that mean I can call it from the browser?](https://help.clatterlabs.com/model-api/security/cors-and-browser-calls): CORS is allowed, but a browser call exposes your key. Call the API from your server. - [What are the x-clatter-notice headers?](https://help.clatterlabs.com/model-api/security/abuse-warning-header): x-clatter-notice: abuse_warning and x-clatter-notice-text mark a request that earned an abuse warning. - [What does Clatter Labs keep when a strike is recorded?](https://help.clatterlabs.com/model-api/security/what-is-kept-after-a-strike): A short, redacted excerpt of the message (no code, no links), erased after 30 days, so an appeal can be reviewed. - [What happens to the text I send to the Model API?](https://help.clatterlabs.com/model-api/security/data-sent-to-the-model-api): It's processed to produce the reply and logged for billing; data use is covered by the Privacy Policy. - [What's the safest way to store Model API keys?](https://help.clatterlabs.com/model-api/security/store-keys-safely): Keep keys in a secret manager or environment variables on the server, one key per service, least permissions. - [Which permissions should my Model API key have?](https://help.clatterlabs.com/model-api/security/least-privilege-keys): Only models:invoke. Add account:read only if the same service needs to read your balance. ### Production and companies - [Can I send my customers' data through the Model API?](https://help.clatterlabs.com/model-api/production/customer-data-and-the-api): Read the Privacy Policy and Terms first, send only what's needed, and remember you're responsible for end-user text. - [Does the Model API have an SLA?](https://help.clatterlabs.com/model-api/production/sla-and-guarantees): No SLA is published in the developer docs. Check the Terms of Service and contact the team for business needs. - [How can a company keep Model API costs predictable?](https://help.clatterlabs.com/model-api/production/choose-efforts-to-control-cost): Default to Flash, route only hard requests to Max or Heavy, cap max_tokens, trim history, and monitor usage. - [How can my team share one Model API bill?](https://help.clatterlabs.com/model-api/production/team-access-to-the-model-api): Invite people to your team in Console › Team; members use the owner's credits within access and limits the owner sets. - [How do I A/B test Flash against Max in production?](https://help.clatterlabs.com/model-api/production/ab-test-tiers): Route a share of a request type to each model, log quality signals, usage and latency per model, and compare. - [How do I avoid my app stopping when credits run out?](https://help.clatterlabs.com/model-api/production/avoid-running-out-of-credits): Monitor the balance with GET /v1/account, alert at a threshold, and top up before it reaches zero. - [How do I give each of my users a spending budget?](https://help.clatterlabs.com/model-api/production/per-user-budgets): Track usage per user from each response, convert it to cost with the model's prices, and stop or slow users at their limit. - [How do I know if the Model API is having problems?](https://help.clatterlabs.com/model-api/production/uptime-and-status): Check status.clatterlabs.com, subscribe to email alerts or RSS, and watch your own 5xx rate. - [How do I monitor abuse warnings across my app?](https://help.clatterlabs.com/model-api/production/monitor-abuse-warnings): Log x-clatter-notice on every response with your user id, alert on the first warning, and block that user quickly. - [How should a SaaS product use the Model API for many customers?](https://help.clatterlabs.com/model-api/production/multi-tenant-saas): One server-side key per service, your own per-customer limits and logs, input moderation, and budget alerts. - [How should I separate development and production?](https://help.clatterlabs.com/model-api/production/separate-dev-and-prod): Use separate keys for each environment, with lower rate limits in development, and label them clearly. - [How should my app degrade if Heavy is slow or busy?](https://help.clatterlabs.com/model-api/production/degrade-gracefully): Set timeouts, stream, and fall back to Max or Flash for the same request when Heavy is overloaded or too slow. - [Should I cache Model API responses?](https://help.clatterlabs.com/model-api/production/cache-responses): For repeated identical questions, caching on your side saves cost and time. Don't cache personal or time-sensitive answers. - [We're a company planning heavy usage. Who do we talk to?](https://help.clatterlabs.com/model-api/production/enterprise-contact): Write to support@clatterlabs.com or team@clatterlabs.xyz with your expected volume; infrastructure questions go to infrastructure@clatterlabs.xyz. - [What should I check before going to production?](https://help.clatterlabs.com/model-api/production/production-checklist): Keys on the server, retries with backoff, error handling, cost monitoring, abuse handling and status alerts. - [What should I log for each Model API call?](https://help.clatterlabs.com/model-api/production/logging-best-practices): Log the X-Request-Id, completion id, model, usage, latency, finish_reason, error code and your own user id. - [What should my app do if the model stays overloaded?](https://help.clatterlabs.com/model-api/production/fallback-when-overloaded): Back off with Retry-After, cap retries, show a friendly message, and check the status page. ### Troubleshooting - [Arabic text from the API looks garbled. How do I fix it?](https://help.clatterlabs.com/model-api/troubleshooting/garbled-arabic-output): It's an encoding issue on your side: read and write UTF-8 everywhere, and use an RTL-aware display. - [I get 404 errors on every request. Is my base URL wrong?](https://help.clatterlabs.com/model-api/troubleshooting/wrong-base-url): Use https://api.gateway.clatterlabs.xyz/v1 as the base URL; the SDK adds /chat/completions. - [I get connection or SSL errors when calling the Model API.](https://help.clatterlabs.com/model-api/troubleshooting/ssl-or-network-errors): Check your network, proxy and system certificates; the API is HTTPS only. - [I get model_not_found but the model id is right. Why?](https://help.clatterlabs.com/model-api/troubleshooting/model-not-found-but-id-is-right): Your SDK may be pointed at another provider's base URL, or a library is overriding the model name. - [My calls work locally but fail with 401 in CI or production. Why?](https://help.clatterlabs.com/model-api/troubleshooting/401-only-in-ci): The key or Account ID isn't set in that environment, or a different key is being used there. Check the secrets. - [My key worked yesterday and now I get 401. What changed?](https://help.clatterlabs.com/model-api/troubleshooting/401-after-it-worked): The key may have been revoked or expired, or the Account ID header changed. Check the exact 401 code. - [My Model API bill is higher than I expected. Why?](https://help.clatterlabs.com/model-api/troubleshooting/costs-higher-than-expected): Long histories, reasoning tokens on Max/Heavy, prompts over 262K tokens and retries all add up. Check Logs. - [My Model API call doesn't work. What should I check first?](https://help.clatterlabs.com/model-api/troubleshooting/nothing-works-checklist): Check the base URL, both headers, the model id, credits, and the error code in the response body. - [My request works in cURL but not in my SDK. Why?](https://help.clatterlabs.com/model-api/troubleshooting/works-in-curl-not-in-sdk): The SDK is probably missing the X-Clatter-Account default header, using another base URL, or calling a different endpoint. - [My streaming code crashes with "choices[0] is undefined". Why?](https://help.clatterlabs.com/model-api/troubleshooting/choices-undefined-in-stream): With include_usage, the final chunk has an empty choices array. Check choices before indexing. - [SuperCosmos doesn't follow my system prompt. What can I do?](https://help.clatterlabs.com/model-api/troubleshooting/model-ignores-system-prompt): Make instructions specific, put them in a system message, give an example, and try Max for complex rules. - [SuperCosmos never calls my tool. Why?](https://help.clatterlabs.com/model-api/troubleshooting/tool-calls-never-happen): The description may not say when to use it, tool_choice may be none, or the request doesn't need it. Force it to test. - [The Playground works but my API calls fail. Why?](https://help.clatterlabs.com/model-api/troubleshooting/playground-works-api-doesnt): The Playground handles authentication for you. Check your own key, models:invoke permission and X-Clatter-Account header. - [The reply's content is empty. Why?](https://help.clatterlabs.com/model-api/troubleshooting/empty-content): The model may have returned tool_calls instead of text, or used all max_tokens on reasoning. Check finish_reason. - [Why are Model API responses slow?](https://help.clatterlabs.com/model-api/troubleshooting/slow-responses): Max and Heavy think before answering; long prompts and outputs take longer. Stream, use Flash, or cap max_tokens. - [Why do I get a different answer every time?](https://help.clatterlabs.com/model-api/troubleshooting/different-answers-each-time): Sampling is random by default. Lower the temperature and set a seed for steadier output. - [Why is the answer cut off?](https://help.clatterlabs.com/model-api/troubleshooting/answers-cut-off): finish_reason length means max_tokens or the model's output cap was reached. Raise max_tokens or ask for a shorter answer. ### Unusual questions - [Can I call the Model API from a spreadsheet or no-code tool?](https://help.clatterlabs.com/model-api/edge-cases/call-it-from-a-spreadsheet): If the tool can send an HTTPS POST with custom headers, yes. Keep the key out of shared sheets. - [Can I create one API key per customer?](https://help.clatterlabs.com/model-api/edge-cases/hundreds-of-keys): An account can hold up to 25 keys, so per-customer keys only work for a few customers. Track customers in your own logs. - [Can I use the Model API in a game or chat bot (like a Discord bot)?](https://help.clatterlabs.com/model-api/edge-cases/api-in-a-game-or-discord-bot): Yes, from your server. Your account is responsible for players' or members' text, so moderate input. - [Can my mobile app use SuperCosmos?](https://help.clatterlabs.com/model-api/edge-cases/call-from-a-phone-app): Yes, through your own server: the app calls your backend, which calls the Model API with the key. - [Does X-Clatter-Account have to be uppercase?](https://help.clatterlabs.com/model-api/edge-cases/lowercase-account-id): No. Account ID matching is case-insensitive, so cl-7k2m9qxa works like CL-7K2M9QXA. - [If I retry a request, am I charged twice?](https://help.clatterlabs.com/model-api/edge-cases/retry-doubles-cost): Each completed request is billed from its own usage, so a retry that completes is billed again. - [If I send the same prompt and seed in parallel, will I get identical answers?](https://help.clatterlabs.com/model-api/edge-cases/same-seed-parallel): Often similar, but not guaranteed: seed gives best-effort repeatability only. - [What happens if I send more than 64 tools?](https://help.clatterlabs.com/model-api/edge-cases/more-than-64-tools): The limit is 64 function tools per request. Choose the relevant tools for each request in your code. - [What happens if I send more than 800 messages?](https://help.clatterlabs.com/model-api/edge-cases/801-messages): The request is refused with 413 request_too_large. Trim or summarise older turns. - [What happens if I send temperature 3 or top_p 0?](https://help.clatterlabs.com/model-api/edge-cases/temperature-out-of-range): Out-of-range values are refused as invalid requests. temperature is 0 to 2; top_p is above 0 up to 1. - [What happens if my request is over 3 MB?](https://help.clatterlabs.com/model-api/edge-cases/over-3-mb): 413 request_too_large. Send less text, or split the work across requests. - [What happens to my API keys if I delete my Clatter Labs account?](https://help.clatterlabs.com/model-api/edge-cases/account-deleted-keys): Your keys stop working with your account. See the account help for what deletion removes. - [What if a tool message has the wrong tool_call_id?](https://help.clatterlabs.com/model-api/edge-cases/wrong-tool-call-id): The tool result must answer a tool call from the previous assistant message; mismatched ids make the request invalid. - [What if I call /v1/embeddings or /v1/responses?](https://help.clatterlabs.com/model-api/edge-cases/embeddings-endpoint): You get 404 not_supported. The Model API offers only GET /v1/models and POST /v1/chat/completions. - [What if I forget Content-Type: application/json?](https://help.clatterlabs.com/model-api/edge-cases/json-content-type-missing): Send the JSON body with Content-Type: application/json. Without it the body may not be read as JSON. - [What if I set max_tokens higher than the model allows?](https://help.clatterlabs.com/model-api/edge-cases/max-tokens-above-the-cap): max_tokens is capped per model: 32,768 output tokens on Flash and Max, 49,152 on Heavy. - [What if I use a colleague's key with my own Account ID?](https://help.clatterlabs.com/model-api/edge-cases/someone-elses-key): It fails with 401 account_mismatch. A key only works with the Account ID that owns it. - [What if I use the same key on several servers?](https://help.clatterlabs.com/model-api/edge-cases/same-key-on-many-servers): It works, but all servers share that key's per-minute limit and log trail. Separate keys are easier to manage. - [What if my users paste logs or messages that contain swearing?](https://help.clatterlabs.com/model-api/edge-cases/logs-with-swearing): Quoted text (code, logs, pasted errors, quotes) doesn't count as abuse. Only insults at the assistant do. - [Will building a profanity filter with SuperCosmos get me a warning?](https://help.clatterlabs.com/model-api/edge-cases/filter-word-list): No. Asking about a word, translating it or building a filter for it doesn't count under the Abuse policy. ## Cosmos Agent API Agent runs, tiers, streamed events, cancelling, scopes and cloud computer metering. ### Getting started - [Can I start runs from my phone?](https://help.clatterlabs.com/agent-api/getting-started/agent-api-from-a-phone): Not with an app, but any tool that can send HTTPS requests with headers works, such as the docs' Try it button in a mobile browser. - [Can I try the Agent API without writing any code?](https://help.clatterlabs.com/agent-api/getting-started/try-the-api-without-writing-code): Use the Try it button on the API reference pages, or the Agent tab in the Console Playground, to send real requests from your browser. - [Can I use the Agent API from no-code tools like automation platforms?](https://help.clatterlabs.com/agent-api/getting-started/agent-api-in-no-code-tools): Yes, if the tool can send HTTP requests with custom headers. Start a run, then poll the run until it's finished. - [Can I use the Agent API on the Free plan?](https://help.clatterlabs.com/agent-api/getting-started/agent-api-on-the-free-plan): Yes. The Agent API is available on every plan, Free included. Runs are paid from credits, and new accounts get $5 of free credit. - [Does Cosmos run anything on my own computer?](https://help.clatterlabs.com/agent-api/getting-started/does-the-agent-run-on-my-computer): No. Agent API runs execute on Clatter Labs infrastructure, on your account's cloud computer, never on your machine. - [How do I check my key, limits and balance in one call?](https://help.clatterlabs.com/agent-api/getting-started/describe-the-api-agent-config): Call GET /agent-config with your key and Account ID to see the API version, the agent's limits, your key's permissions and your balance. - [How do I start my first Agent API run?](https://help.clatterlabs.com/agent-api/getting-started/how-to-start-your-first-run): Create a key, copy your Account ID and send your first run to the Cosmos Agent API in about five minutes. - [How is the Agent API versioned, and how will I know about changes?](https://help.clatterlabs.com/agent-api/getting-started/api-version-and-changes): The Agent API version is a date returned by /agent-config. Breaking changes get a new version and a changelog entry. - [I'm learning to code. Is the Agent API a good way to learn?](https://help.clatterlabs.com/agent-api/getting-started/agent-api-for-students-and-learners): How students and new coders can use the Agent API safely and cheaply to learn, plus simpler alternatives. - [I've never used an API. What is it?](https://help.clatterlabs.com/agent-api/getting-started/what-is-an-api): An API is a way for one program to ask another for something over the internet. Here's how that applies to the Cosmos Agent API. - [Is the Agent API in beta or generally available?](https://help.clatterlabs.com/agent-api/getting-started/is-the-agent-api-in-beta): The Cosmos Agent API is generally available on every plan, Free included, and paid from credits. - [Is there an official SDK for the Agent API?](https://help.clatterlabs.com/agent-api/getting-started/is-there-an-sdk): The Agent API is plain HTTPS and JSON, so any HTTP client works. The docs show cURL, Python and JavaScript examples. - [What are server-sent events (SSE)?](https://help.clatterlabs.com/agent-api/getting-started/what-is-sse): SSE is a simple web standard for a server to send a stream of updates over one open connection. The Agent API uses it for run events. - [What can Cosmos actually do during a run?](https://help.clatterlabs.com/agent-api/getting-started/what-can-cosmos-do-in-a-run): The tools Cosmos uses in an Agent API run: terminal, files, browser, web search, Cloud Repos, hosting, storage, sub-agents and more. - [What do I need before I can call the Agent API?](https://help.clatterlabs.com/agent-api/getting-started/what-you-need-before-you-start): A Clatter Labs account, its Account ID, an API key with the right permissions, and credits. Here's how to get each. - [What do the Agent API terms mean?](https://help.clatterlabs.com/agent-api/getting-started/agent-api-glossary): A short glossary: run, step, tier, output, files, cloud computer, sub-agent, credits, scope, Account ID and event stream. - [What do the run statuses queued, running, completed, failed and cancelled mean?](https://help.clatterlabs.com/agent-api/getting-started/run-lifecycle-statuses): The five statuses a Cosmos Agent run can have, how a run moves between them and which ones are final. - [What is a run?](https://help.clatterlabs.com/agent-api/getting-started/what-is-a-run): A run is one task you give Cosmos through the Agent API, from your instructions to its final answer and files. - [What is the base URL of the Agent API?](https://help.clatterlabs.com/agent-api/getting-started/base-url-of-the-agent-api): The Agent API lives at https://api.agent.clatterlabs.xyz. All requests use HTTPS and JSON, except the event stream. - [What is the Cosmos Agent API?](https://help.clatterlabs.com/agent-api/getting-started/what-is-the-cosmos-agent-api): The Cosmos Agent API lets your apps hand coding tasks to Cosmos, an AI agent that works on its own cloud computer and reports back. - [What's the difference between the Agent API and the Model API?](https://help.clatterlabs.com/agent-api/getting-started/agent-api-vs-model-api): The Model API returns model replies to your prompts; the Agent API runs a full agent with tools on a cloud computer until a task is done. - [Where can I see the runs I've started?](https://help.clatterlabs.com/agent-api/getting-started/where-to-see-my-runs): List runs with GET /v1/runs, open one with GET /v1/runs/{id}, or see recent API runs under Logs in the Console. - [Which AI model does Cosmos use?](https://help.clatterlabs.com/agent-api/getting-started/which-model-powers-cosmos): Cosmos Agent thinks with SuperCosmos by Clatter Labs, version 1.1, in three tiers: Flash, Max and Heavy. - [Which programming languages and tools can Cosmos work with?](https://help.clatterlabs.com/agent-api/getting-started/what-languages-can-cosmos-code-in): Cosmos works in a Linux terminal where it can install packages, so it can use common languages and toolchains you ask for. - [Who is the Cosmos Agent API for?](https://help.clatterlabs.com/agent-api/getting-started/who-is-the-agent-api-for): Developers, teams and companies that want an AI coding agent inside their own tools, scripts, CI jobs or products. - [Why does creating a run return so quickly if the work takes longer?](https://help.clatterlabs.com/agent-api/getting-started/agent-api-response-time): POST /v1/runs answers 201 right away and the work happens in the background. Follow it with events or polling. ### API keys and authentication - [Can I call the Agent API from a browser or mobile app?](https://help.clatterlabs.com/agent-api/keys-and-auth/keep-api-keys-out-of-frontend): The API allows cross-origin requests, but never put a clsk_ key in front-end or mobile code. Call it from your server. - [Can I change a key's permissions or rate limit after creating it?](https://help.clatterlabs.com/agent-api/keys-and-auth/change-key-permissions): Permissions and rate limit are set when you create a key. To change them, create a new key and revoke the old one. - [Can I get an Agent API key without using the Console?](https://help.clatterlabs.com/agent-api/keys-and-auth/need-console-for-keys): No. Keys are created in Console › API keys. After that, everything else can be done over the API. - [Can I start runs for another Clatter Labs account?](https://help.clatterlabs.com/agent-api/keys-and-auth/act-for-another-account): No. A key only works with its owner's Account ID. For shared work, use Team in the Console so members use the owner's plan and credits. - [Does the Account ID have to be in capital letters?](https://help.clatterlabs.com/agent-api/keys-and-auth/account-id-is-case-insensitive): No. X-Clatter-Account matching is case-insensitive, so CL-7K2M9QXA and cl-7k2m9qxa are treated the same. - [How many API keys can I have?](https://help.clatterlabs.com/agent-api/keys-and-auth/how-many-api-keys): An account can hold up to 25 API keys. Each key has its own permissions and rate limit. - [How should I store my API key and Account ID in my code?](https://help.clatterlabs.com/agent-api/keys-and-auth/api-key-in-env-variables): Keep the key in an environment variable or secret manager, never in source code. The docs use CLATTER_API_KEY and CLATTER_ACCOUNT_ID. - [What does the clsk_ at the start of my key mean?](https://help.clatterlabs.com/agent-api/keys-and-auth/what-does-clsk-mean): All Clatter Labs Console API keys start with clsk_. It helps you and secret scanners recognise them. - [What is the X-Clatter-Account header and why is it required?](https://help.clatterlabs.com/agent-api/keys-and-auth/what-is-x-clatter-account): X-Clatter-Account carries the Account ID that owns your key. It means a leaked key alone isn't enough to act on your account. - [Which permissions should I give an Agent API key?](https://help.clatterlabs.com/agent-api/keys-and-auth/which-permissions-should-my-key-have): Give each key only what it needs: runs:write to start runs, runs:read to read them, account:read for balance and usage. - [Who owns the API keys in a company account?](https://help.clatterlabs.com/agent-api/keys-and-auth/company-key-ownership): Keys belong to the account that created them. Requests must send that account's ID. Use the Console Team feature for colleagues. - [Why can't I see my API key again after creating it?](https://help.clatterlabs.com/agent-api/keys-and-auth/key-shown-only-once): Clatter Labs stores only a keyed hash of each key, so it can't be shown again. Create a new key if you lose it. - [Why does /agent-config work without a key?](https://help.clatterlabs.com/agent-api/keys-and-auth/agent-config-without-key): It's a public description of the API: version, endpoints, tools and limits. Send a key to also see your key and balance. ### Creating runs - [Can a run call external APIs or send data to other services?](https://help.clatterlabs.com/agent-api/creating-runs/can-cosmos-call-external-apis): Runs can fetch web pages and use connected apps on your account. Don't paste credentials; connect services instead. - [Can Cosmos work on my GitHub repository?](https://help.clatterlabs.com/agent-api/creating-runs/run-from-a-git-repo): Cosmos works on its cloud computer. It can fetch public code, or use connected apps on your account; it can't reach your machine. - [Can I attach files or images to a run?](https://help.clatterlabs.com/agent-api/creating-runs/attach-files-to-a-run): Runs take text input only. Paste text into input, give a URL Cosmos can fetch, or keep files on your cloud computer. - [Can I change a run's title or metadata after creating it?](https://help.clatterlabs.com/agent-api/creating-runs/rename-run-or-change-metadata): No. title and metadata are set at creation. Keep anything that changes later in your own records, keyed by the run id. - [Can I limit how long a run takes or how many steps it uses?](https://help.clatterlabs.com/agent-api/creating-runs/can-i-set-a-time-or-step-limit): There's no request field for a time or step budget. Put limits in your instructions, watch the stream, and cancel if needed. - [Can I put passwords or API tokens in my instructions?](https://help.clatterlabs.com/agent-api/creating-runs/secrets-in-input): No. Don't paste secrets into input. Connect services to your account instead, and treat runs as something others on your team may read. - [Can I send a follow-up message to a run that's already going?](https://help.clatterlabs.com/agent-api/creating-runs/can-i-send-follow-up-messages): The Agent API has no endpoint for adding messages to a run. Start a new run that continues the work instead. - [Can I start lots of runs at the same time?](https://help.clatterlabs.com/agent-api/creating-runs/starting-many-runs): Up to 5 runs can be queued or running per account. A sixth answers 429 too_many_runs. Queue the rest in your own code. - [Can I use the Agent API for things that aren't coding?](https://help.clatterlabs.com/agent-api/creating-runs/run-for-non-coding-tasks): Cosmos is built for coding work, but it can also browse, research and produce files. Here's what fits well. - [Can I write instructions in a language other than English?](https://help.clatterlabs.com/agent-api/creating-runs/instructions-in-other-languages): input is plain text, so you can write in other languages. Say which language you want the answer and code comments in. - [Can the Agent API notify my server when a run finishes?](https://help.clatterlabs.com/agent-api/creating-runs/webhooks-when-run-finishes): The API doesn't describe webhooks. Keep an event stream open until the done event, or poll the run every few seconds. - [Does a run keep going if my script stops or my connection drops?](https://help.clatterlabs.com/agent-api/creating-runs/do-runs-continue-if-i-disconnect): Yes. Runs keep going if you disconnect, and long tasks continue past any single request's time limit, up to 150 steps. - [How can a new run continue work from an earlier run?](https://help.clatterlabs.com/agent-api/creating-runs/run-continues-from-earlier-work): Ask runs to keep work in a Cloud Repo, hosting or storage on your cloud computer, then point the next run at it by name. - [How do I get structured JSON back from a run?](https://help.clatterlabs.com/agent-api/creating-runs/structured-json-output): Ask for it in the instructions and have Cosmos save it as an output file, then parse the file content from ?include=files. - [How do I include code or logs in my instructions?](https://help.clatterlabs.com/agent-api/creating-runs/run-input-with-code-snippet): Paste them into input inside fenced blocks, keep only the relevant parts, and stay within 20,000 characters. - [How do I use metadata to link runs to my own records?](https://help.clatterlabs.com/agent-api/creating-runs/what-is-run-metadata): Put your own ids in metadata (up to 2 KB of JSON). It's returned unchanged on the run, so you can match runs to tickets or users. - [How do I write instructions that Cosmos does well?](https://help.clatterlabs.com/agent-api/creating-runs/write-good-instructions): Write input like a ticket: the goal, the constraints and what "done" looks like. Name files, set limits and ask for proof. - [How long does a run take?](https://help.clatterlabs.com/agent-api/creating-runs/how-long-does-a-run-take): It depends on the task and tier. Small tasks finish quickly; big ones can take many steps, up to 150 per run. - [I'm new to this. What's a good first thing to ask Cosmos?](https://help.clatterlabs.com/agent-api/creating-runs/kids-what-should-i-ask-cosmos): Easy, fun first tasks for beginners and young coders, with example instructions you can copy. - [If my create request times out, will retrying start a duplicate run?](https://help.clatterlabs.com/agent-api/creating-runs/idempotent-run-creation): A retry after a timeout may start a second run. Check GET /v1/runs for the first one before retrying, using metadata to find it. - [My instructions are longer than 20,000 characters. What can I do?](https://help.clatterlabs.com/agent-api/creating-runs/input-too-long): input is capped at 20,000 characters. Trim it, link to the material, or keep large files on the cloud computer for Cosmos to read. - [Should I let Cosmos deploy to my production servers?](https://help.clatterlabs.com/agent-api/creating-runs/let-cosmos-deploy-to-production): Treat agent changes like a pull request: review them and deploy through your own pipeline. Runs can host on clatterai.com for previews. - [What are good example instructions for common tasks?](https://help.clatterlabs.com/agent-api/creating-runs/example-instructions-for-common-tasks): Copyable input examples for tests, bug fixes, scripts, docs, refactors and website checks, each with a clear "done" condition. - [What are sub-agents in a run?](https://help.clatterlabs.com/agent-api/creating-runs/run-sub-agents): For bigger jobs, Cosmos can split a run into parallel sub-agents, then bring the results together. Cancelling a run stops them too. - [What fields can I send when creating a run?](https://help.clatterlabs.com/agent-api/creating-runs/create-a-run-request-fields): POST /v1/runs takes input (required), title, tier and metadata. Here are the limits and defaults for each. - [What happens if Cosmos needs to ask me something during a run?](https://help.clatterlabs.com/agent-api/creating-runs/cosmos-needs-to-ask-a-question): Runs can't receive replies mid-run. Cosmos decides and explains in its output, so state assumptions and preferences up front. - [What happens right after I create a run?](https://help.clatterlabs.com/agent-api/creating-runs/what-happens-after-creating-a-run): The API answers 201 immediately with the run. Cosmos starts working on its cloud computer; follow it with the event stream or by polling. - [What is a run's title for, and can I leave it out?](https://help.clatterlabs.com/agent-api/creating-runs/run-title): title is an optional short name (up to 80 characters). If you leave it out, the first line of input is used. - [Will the same instructions always give the same result?](https://help.clatterlabs.com/agent-api/creating-runs/reproducible-runs): Not exactly. An agent makes choices as it works, so results can differ. Pin versions, specify steps and verify with tests. ### Tiers: auto, Flash, Max and Heavy - [Can Cosmos look at screenshots or images?](https://help.clatterlabs.com/agent-api/tiers/can-cosmos-read-images): SuperCosmos reads text only and doesn't take image input, so runs can't receive images from you. - [Can I change a run's tier after it has started?](https://help.clatterlabs.com/agent-api/tiers/change-tier-mid-run): No. The tier is set when the run is created. Cancel it and start a new run with the tier you want. - [Can I use Line Code in the Agent API?](https://help.clatterlabs.com/agent-api/tiers/line-code-in-agent-api): No. Agent API runs use SuperCosmos tiers only, and Line Code was retired on Nov 1, 2026. - [Does a higher tier make runs slower?](https://help.clatterlabs.com/agent-api/tiers/tier-and-speed): Usually yes per step: Max and Heavy think before acting. But they may need fewer steps on hard tasks, so total time can vary. - [Does Heavy have a bigger context window than Flash?](https://help.clatterlabs.com/agent-api/tiers/heavy-context-window): No. All tiers are SuperCosmos 1.1 with the same 1M-token window; they differ in how much they think per step. - [How do I compare tiers on the same task?](https://help.clatterlabs.com/agent-api/tiers/same-task-different-tiers): Run the same input on two tiers, then compare output quality, steps and token usage before choosing a default. - [How is each tier billed on the Agent API?](https://help.clatterlabs.com/agent-api/tiers/how-tiers-are-billed): Tokens are billed at the tier each call actually ran on. auto runs bill as Flash. Computer time and other items cost the same on every tier. - [How much can Cosmos keep in mind during a run?](https://help.clatterlabs.com/agent-api/tiers/context-window-in-runs): SuperCosmos 1.1 has a 1M-token context window on every tier. Prompts above 262K tokens bill input at 1.5×. - [I get 400 bad_request when setting tier. What's wrong?](https://help.clatterlabs.com/agent-api/tiers/invalid-tier-value): tier must be exactly auto, flash, max or heavy, in lowercase. Model ids like supercosmos-max belong to the Model API. - [Should I just use heavy for every run to get the best results?](https://help.clatterlabs.com/agent-api/tiers/heavy-for-everything): Usually not. Heavy is slower and costs more. The docs recommend auto or flash for most runs and heavy only for the hard ones. - [What are the Agent API tiers auto, flash, max and heavy?](https://help.clatterlabs.com/agent-api/tiers/what-are-tiers): Tiers choose how much SuperCosmos thinks on each step. auto lets Cosmos route; flash is fastest; max plans; heavy thinks longest. - [Which SuperCosmos version do my runs use?](https://help.clatterlabs.com/agent-api/tiers/supercosmos-version-in-runs): SuperCosmos 1.1 is the current model behind Clatter Labs products, including the Agent API, at the same prices as 1.0. - [Which tier should I pick for my run?](https://help.clatterlabs.com/agent-api/tiers/which-tier-should-i-pick): Start with auto or flash. Move a type of run to max or heavy only when you see it struggle. - [Why does my finished run still say tier: auto?](https://help.clatterlabs.com/agent-api/tiers/tier-field-on-run-object): The run's tier field shows the tier you asked for, not each step's routed tier. auto runs are billed as Flash. ### Streaming events - [Can I see how Cosmos is thinking?](https://help.clatterlabs.com/agent-api/streaming-events/see-cosmos-reasoning): You see its messages and tool calls as steps in the event stream. Hidden reasoning isn't returned, though it's billed as output. - [Can I watch what Cosmos sees in its browser?](https://help.clatterlabs.com/agent-api/streaming-events/watch-cosmos-browser): The stream shows browser actions as tool steps with short arguments and output. Screenshots aren't part of the published API. - [Does an open event stream use up my rate limit?](https://help.clatterlabs.com/agent-api/streaming-events/count-stream-against-rate-limit): An open stream counts once, when you open it, however long it runs. Reconnecting counts as a new request. - [How do I follow a run live with server-sent events?](https://help.clatterlabs.com/agent-api/streaming-events/how-to-stream-run-events): Open GET /v1/runs/{id}/events and read status, step and done events. Any SSE client or a line reader works. - [How do I follow several runs at once?](https://help.clatterlabs.com/agent-api/streaming-events/events-for-multiple-runs): Open one event stream per run (up to 5 runs are in progress per account), or poll each run, keeping an eye on your rate limit. - [How do I read the event stream in JavaScript?](https://help.clatterlabs.com/agent-api/streaming-events/stream-in-javascript): Use fetch and read the body as text, splitting events on blank lines. Browser EventSource can't send the auth headers. - [How do I read the event stream in Python?](https://help.clatterlabs.com/agent-api/streaming-events/stream-in-python-requests): Use requests with stream=True and iter_lines, parse event and data lines, and reconnect with ?after= after a timeout. - [How do I reconnect to a stream without missing or repeating steps?](https://help.clatterlabs.com/agent-api/streaming-events/reconnect-stream-with-after): Count the step events you've received and reconnect with ?after= that number. The stream continues from the next step. - [How do I show a run's progress to my own users?](https://help.clatterlabs.com/agent-api/streaming-events/show-progress-to-users): Stream events on your server and forward simple progress updates to your app. Never expose your key to the browser. - [My stream ended with an error event. What now?](https://help.clatterlabs.com/agent-api/streaming-events/stream-error-event): An error event means the stream had to stop, for example because the key was revoked. Check the code, then reconnect if appropriate. - [My stream works locally but not behind our company proxy. Why?](https://help.clatterlabs.com/agent-api/streaming-events/stream-through-proxy): Some proxies buffer or close long-lived connections. Disable buffering for the stream, reconnect with ?after=, or fall back to polling. - [Should I stream events or poll for the result?](https://help.clatterlabs.com/agent-api/streaming-events/stream-vs-polling): Streaming is recommended: one connection replaces dozens of GET calls. If you poll, wait at least 2 seconds between calls. - [What event types does the run event stream send?](https://help.clatterlabs.com/agent-api/streaming-events/sse-event-types): status, step, done, timeout and error: what each Agent API stream event means and the data it carries. - [What happens if I open the stream for a run that already finished?](https://help.clatterlabs.com/agent-api/streaming-events/stream-a-finished-run): The stream is meant to end with a done event carrying the final run, so you get the result. You can also just GET the run. - [What's inside a step event?](https://help.clatterlabs.com/agent-api/streaming-events/step-object-fields): A step is a message (text) or a tool call (name, ok, args, output), with an index. Long fields are capped in the stream. - [Why does my event stream stop after 10 minutes?](https://help.clatterlabs.com/agent-api/streaming-events/stream-stops-after-ten-minutes): Each stream connection lasts up to 10 minutes and ends with a timeout event. The run continues; reconnect with ?after=. - [Why is tool output cut short in the stream?](https://help.clatterlabs.com/agent-api/streaming-events/stream-shows-truncated-output): Stream steps are capped: text at 4,000 characters, args at 400 and output at 600. Read the full run with GET /v1/runs/{id}. ### Results, listing and cancelling - [Can I delete a run and its data?](https://help.clatterlabs.com/agent-api/managing-runs/delete-a-run): The Agent API has no delete endpoint for runs. For permanent deletion of your data, email infrastructure@clatterlabs.xyz. - [GET /v1/runs/{id} answers 404 not_found. Why?](https://help.clatterlabs.com/agent-api/managing-runs/run-not-found): There's no run with that id on your account. Check the id, the Account ID you're sending and whether the run came from the API. - [How do I cancel a run?](https://help.clatterlabs.com/agent-api/managing-runs/cancel-a-run): POST /v1/runs/{id}/cancel stops a queued or running run at its next step, along with any sub-agents it started. - [How do I export my run history?](https://help.clatterlabs.com/agent-api/managing-runs/export-run-history): Page through GET /v1/runs and save each run's fields; fetch ?include=files for outputs you need. Console Usage covers spend. - [How do I find a run using my own ticket or user id?](https://help.clatterlabs.com/agent-api/managing-runs/find-run-by-metadata): List runs and filter on metadata in your code. There's no server-side metadata search, so page through GET /v1/runs. - [How do I get a run's final answer and files?](https://help.clatterlabs.com/agent-api/managing-runs/get-a-run-result): Call GET /v1/runs/{id}. output holds the final answer; files lists saved outputs. Add ?include=files for their contents. - [How do I list my runs and page through older ones?](https://help.clatterlabs.com/agent-api/managing-runs/list-runs-and-paging): GET /v1/runs returns API runs newest first, 20 by default and up to 100. Pass the last created_at as before to get older ones. - [How do I make sure I get a file back from a run?](https://help.clatterlabs.com/agent-api/managing-runs/get-files-back-from-a-run): Ask Cosmos to save the file as an output, by name. It then appears in the run's files array, with content via ?include=files. - [How do I stop all my runs at once?](https://help.clatterlabs.com/agent-api/managing-runs/cancel-all-running-runs): List runs with GET /v1/runs, then cancel each queued or running one with POST /v1/runs/{id}/cancel. - [How long are my runs and their results kept?](https://help.clatterlabs.com/agent-api/managing-runs/how-long-are-runs-kept): The Agent API docs don't publish a retention period for runs. Save outputs you need on your side, and ask us for deletion if needed. - [What do run ids and key ids look like?](https://help.clatterlabs.com/agent-api/managing-runs/run-id-format): Run ids are UUIDs, like 4f0c2a6e-8d1b-4c3a-9f21-6b1e2d7c9a10. Key ids start with key_. - [What does usage.tokens on a run tell me?](https://help.clatterlabs.com/agent-api/managing-runs/usage-tokens-on-a-run): usage.tokens is the number of tokens the run used. For cost, see the Console's Usage page or GET /v1/account. - [What happens if I cancel a run that already finished?](https://help.clatterlabs.com/agent-api/managing-runs/cancel-a-finished-run): Cancel stops queued or running runs. A run that's already completed, failed or cancelled has nothing left to stop. - [What is key_id on a run?](https://help.clatterlabs.com/agent-api/managing-runs/key-id-on-runs): key_id identifies the API key that created the run, so you can tell which integration started it. - [What time zone are run timestamps in?](https://help.clatterlabs.com/agent-api/managing-runs/timestamps-time-zone): created_at and updated_at are ISO 8601 timestamps. The examples use UTC (ending in Z). Convert to local time in your app. - [Why does the run only show the first part of my input?](https://help.clatterlabs.com/agent-api/managing-runs/run-input-truncated): The run object returns the first 4,000 characters of input. Cosmos still received your full instructions (up to 20,000 characters). - [Why is output null on my run?](https://help.clatterlabs.com/agent-api/managing-runs/output-is-null): output is filled only when a run completes. While it's queued or running, or if it failed or was cancelled, output is null. ### Cloud computer, browser and storage - [A run deleted or broke files on my cloud computer. What can I do?](https://help.clatterlabs.com/agent-api/cloud-computer/run-deleted-my-files): Check Cloud Repo history to recover code, ask a new run to restore it, and limit future runs with clear instructions. - [Can Cosmos access the internet during a run?](https://help.clatterlabs.com/agent-api/cloud-computer/cloud-computer-internet-access): Yes, runs can search the web, fetch pages and use a Chromium browser. They can't reach your private network or local machine. - [Can Cosmos deploy a website or API for me?](https://help.clatterlabs.com/agent-api/cloud-computer/hosting-on-clatterai): Yes. Runs can deploy sites and APIs to .clatterai.com hosting on your cloud computer, with DNS, a SQL database and key-value storage. - [Can Cosmos install packages and dependencies?](https://help.clatterlabs.com/agent-api/cloud-computer/cosmos-installing-packages): Yes. Cosmos uses a Linux terminal to install packages, run builds and run tests. Put limits in your instructions if you want fewer dependencies. - [Can Cosmos use my other tools and services during a run?](https://help.clatterlabs.com/agent-api/cloud-computer/connected-apps-and-mcp): Runs can use the connectors and MCP servers on your account. That's the safe alternative to pasting tokens into instructions. - [Can Cosmos work with my own database?](https://help.clatterlabs.com/agent-api/cloud-computer/cosmos-access-my-database): If the database is reachable from the internet or connected to your account, yes. It can't reach private networks. - [Can I trust the code Cosmos writes?](https://help.clatterlabs.com/agent-api/cloud-computer/review-agent-output): Treat outputs as untrusted until you've reviewed them, like any code from a pull request. Ask Cosmos to prove its work. - [Do all my runs share the same cloud computer?](https://help.clatterlabs.com/agent-api/cloud-computer/cloud-computer-shared-between-runs): Yes. Each account has its own cloud computer that its runs use, which is why work saved there is available to later runs. - [Do team members share the owner's cloud computer?](https://help.clatterlabs.com/agent-api/cloud-computer/cloud-computer-and-teams): Team members use the owner's plan and credits. The docs don't say more about shared cloud computers; contact support for team setups. - [Does Cosmos remember things between runs?](https://help.clatterlabs.com/agent-api/cloud-computer/does-cosmos-remember-between-runs): Cosmos has a memory tool to remember what it learned for later runs, and work saved on your cloud computer stays there. - [How can Agent API runs use files from Code Buckets?](https://help.clatterlabs.com/agent-api/cloud-computer/agent-runs-and-code-buckets): Give Cosmos the public link of a file in Code Buckets, or ask it to save outputs you then upload to a bucket from your own code. - [How do I clean up old projects on my cloud computer?](https://help.clatterlabs.com/agent-api/cloud-computer/clean-up-cloud-computer): Ask a run to remove the Cloud Repos, hosted sites or stored data you no longer need, and confirm what it deleted. - [What are Cloud Repos?](https://help.clatterlabs.com/agent-api/cloud-computer/cloud-repos): Cloud Repos keep code with history on your account's cloud computer, so later runs can continue from it. - [What counts as an "action" on my bill?](https://help.clatterlabs.com/agent-api/cloud-computer/what-counts-as-an-action): Each file edit, command, web search or tool call is one action, billed at $0.0005. - [What does "$0.10 per GB written" cover?](https://help.clatterlabs.com/agent-api/cloud-computer/storage-writes-billing): Files and outputs written to the cloud computer and run results are billed at $0.10 per GB written. - [What if a run needs to download or create very large files?](https://help.clatterlabs.com/agent-api/cloud-computer/big-downloads-in-a-run): Large files cost storage writes at $0.10 per GB plus computer time. Keep them on the cloud computer or Code Buckets rather than as outputs. - [What if two runs change the same Cloud Repo at the same time?](https://help.clatterlabs.com/agent-api/cloud-computer/two-runs-same-repo): Runs share your account's cloud computer, so parallel runs on one project can conflict. Give parallel runs separate repos or folders. - [What is the cloud computer that runs use?](https://help.clatterlabs.com/agent-api/cloud-computer/what-is-the-cloud-computer): Every account has its own cloud computer: a Linux terminal and files, a Chromium browser, a database, storage, hosting and Cloud Repos. - [When am I billed for cloud browser time?](https://help.clatterlabs.com/agent-api/cloud-computer/browser-time-billing): Cloud browser time is billed at $0.005 per minute for navigation, clicks and typing in the run's Chromium browser. ### Billing and credits - [A run did poor work. Can I get my credits back?](https://help.clatterlabs.com/agent-api/billing-and-credits/refund-for-agent-run): Runs are billed for the work done. If you believe you were charged wrongly, email support with your Account ID and run ids. - [Are my credits shared between the Agent API and the Model API?](https://help.clatterlabs.com/agent-api/billing-and-credits/credits-shared-with-model-api): Yes. There's one credit balance per Account ID, used by both the Agent API and the Model API. - [Can I set a spending limit for the Agent API?](https://help.clatterlabs.com/agent-api/billing-and-credits/spending-limits-for-agent-api): Your credit balance is a natural cap. Teams can set per-member monthly limits; you can also enforce budgets in your own code. - [Does changing or cancelling my plan affect the Agent API?](https://help.clatterlabs.com/agent-api/billing-and-credits/plan-change-and-agent-api): No. Plans cover app usage; the Agent API is pay as you go from credits on every plan, Free included. - [How do I build my own low-balance alert for the Agent API?](https://help.clatterlabs.com/agent-api/billing-and-credits/low-balance-alerts): Poll GET /v1/account on a schedule with a read-only key and alert yourself when balance_usd drops below your threshold. - [How do I get an invoice for Agent API usage?](https://help.clatterlabs.com/agent-api/billing-and-credits/agent-api-invoices): Credit purchases and billing history are in Console › Billing. For a specific invoice need, email support. - [How do I test my integration without spending much?](https://help.clatterlabs.com/agent-api/billing-and-credits/test-without-spending): Check keys with /agent-config, use tiny tasks on flash, keep a small top-up as a cap, and mock the API in unit tests. - [How is the Agent API billed?](https://help.clatterlabs.com/agent-api/billing-and-credits/how-agent-api-is-billed): Agent API runs are pay as you go from your credit balance: tokens at the tier each call ran on, plus computer time, actions, browser and storage. - [My paid plan doesn't seem to cover Agent API runs. Why?](https://help.clatterlabs.com/agent-api/billing-and-credits/does-my-plan-cover-agent-api): Plans cover app usage only. The Agent API and Model API are always paid from credits, on every plan. - [My run failed with out_of_credits halfway through. What happened?](https://help.clatterlabs.com/agent-api/billing-and-credits/out-of-credits-mid-run): Your balance reached zero during the run, so it stopped as failed with error.code out_of_credits. Top up and start a new run. - [What do metered_usd and "unlimited" mean in my account data?](https://help.clatterlabs.com/agent-api/billing-and-credits/team-account-unlimited): metered_usd is the list price of everything metered. It equals spent_usd unless the account is a Clatter Labs team account. - [Who pays when a team member starts a run?](https://help.clatterlabs.com/agent-api/billing-and-credits/who-pays-for-team-runs): Team members use the owner's plan and credits, so the owner's balance pays, within limits the owner sets. - [Why does GET /v1/account show Line CLI usage too?](https://help.clatterlabs.com/agent-api/billing-and-credits/account-shows-line-usage): The account endpoint reports 30 days of usage across Line CLI, Cosmos Agent and the Agent API, split in by_product_30d. ### Rate limits and run limits - [How does the per-key rate limit work?](https://help.clatterlabs.com/agent-api/limits/requests-per-minute-limit): Each key allows 10, 30, 60 or 120 requests per minute. Responses show X-RateLimit-Limit and Remaining; 429 adds Retry-After. - [How often should I poll a run?](https://help.clatterlabs.com/agent-api/limits/polling-interval): Every 2 seconds or more. Faster polling eats your per-key rate limit; streaming avoids polling entirely. - [I get 413 too_large. Which limit did I hit?](https://help.clatterlabs.com/agent-api/limits/metadata-too-large): input over 20,000 characters, metadata over 2 KB or a body over 64 KB answers 413 too_large. Check each. - [I get 429 too_many_runs. What does it mean?](https://help.clatterlabs.com/agent-api/limits/too-many-runs-in-progress): Your account already has 5 runs queued or running. Wait for one to finish or cancel one, then start the next. - [My run stopped before finishing a big task. Did it hit the step limit?](https://help.clatterlabs.com/agent-api/limits/run-hit-150-steps): Runs take up to 150 steps. Split very large jobs into smaller runs that continue from a Cloud Repo. - [What are the Agent API's limits?](https://help.clatterlabs.com/agent-api/limits/agent-api-limits-overview): Every Agent API limit in one table: input, metadata, body size, steps, runs in progress, stream length, rate limits and keys. - [Why can I only run 5 runs at once?](https://help.clatterlabs.com/agent-api/limits/why-five-runs-limit): The limit of 5 runs queued or running per account keeps the service fair and costs predictable. Queue the rest in your code. ### Errors and troubleshooting - [Can I rely on the error message text in my code?](https://help.clatterlabs.com/agent-api/errors/error-message-language): No. Branch on error.code, which is stable. message is human-readable and can change. - [How do I fix 402 out_of_credits?](https://help.clatterlabs.com/agent-api/errors/error-out-of-credits): Your credit balance is used up. Add credits in Console › Billing › Credits. Retrying without topping up won't help. - [How do I know if the Agent API is having problems?](https://help.clatterlabs.com/agent-api/errors/agent-api-status-and-outages): Check status.clatterlabs.com for live health and incidents. Persistent 502 or 503 errors are a sign to look there. - [How should my code handle Agent API errors?](https://help.clatterlabs.com/agent-api/errors/handle-errors-in-code): A simple strategy: fix 4xx request errors, wait on 429, stop on 402, and retry 502/503 with backoff. - [I get a CORS or network error calling the API from my web page. Why?](https://help.clatterlabs.com/agent-api/errors/cors-error-in-browser): Browsers block some requests, and keys don't belong in front-end code anyway. Call the Agent API from your backend instead. - [My create request fails though input is set. What else can be wrong?](https://help.clatterlabs.com/agent-api/errors/create-request-fails-json): Check Content-Type: application/json, valid JSON (escape quotes and newlines), and that you're sending POST to /v1/runs. - [My requests fail with a strange HTML page or a 403 that isn't JSON. Why?](https://help.clatterlabs.com/agent-api/errors/requests-blocked-by-firewall): A non-JSON response usually comes from a proxy, firewall or security filter in between. Try another network or a standard HTTP client. - [My run ended with error code run_failed. What can I do?](https://help.clatterlabs.com/agent-api/errors/run-failed-run-failed): run_failed means the run started but couldn't finish for a reason other than credits. Read the message and steps, then retry with clearer instructions. - [My run has been "running" for a long time. Is it stuck?](https://help.clatterlabs.com/agent-api/errors/run-stuck-in-running): Long tasks can take many steps. Check the event stream for recent steps; if nothing moves for a long time, cancel and retry. - [What do all the Agent API error codes mean?](https://help.clatterlabs.com/agent-api/errors/agent-api-error-codes): Every Agent API error code with its HTTP status, meaning and what to do, in one table. - [What does 400 bad_request mean when creating a run?](https://help.clatterlabs.com/agent-api/errors/error-bad-request): input is missing or empty, or tier isn't auto, flash, max or heavy. The message says which. - [What does 403 early_access mean?](https://help.clatterlabs.com/agent-api/errors/error-early-access): The account isn't in the early-access program yet. Check you're using the right Account ID, then contact support with your Account ID. - [What does 403 no_cloud_account mean?](https://help.clatterlabs.com/agent-api/errors/error-no-cloud-account): Your account hasn't been set up for Cosmos Agent yet. Follow the docs' steps, and contact support with your Account ID if it persists. - [What does 404 not_found mean on the Agent API?](https://help.clatterlabs.com/agent-api/errors/error-not-found): No run with that id exists on your account. Check the id and the Account ID, or the URL path. - [What does 405 method_not_allowed mean?](https://help.clatterlabs.com/agent-api/errors/error-method-not-allowed): You used the wrong HTTP method for this endpoint, such as GET on /v1/runs/{id}/cancel. Use the method in the reference. - [What should I do about 502 upstream?](https://help.clatterlabs.com/agent-api/errors/error-upstream-502): The service behind the API didn't answer. Retry with backoff and check status.clatterlabs.com if it continues. - [What should I do about 503 unavailable?](https://help.clatterlabs.com/agent-api/errors/error-unavailable-503): The key couldn't be checked right now. Retry with backoff; it's usually brief. ### Safety and the abuse policy - [How do I report a security problem with the Agent API?](https://help.clatterlabs.com/agent-api/safety-and-abuse/report-a-security-issue): Email security details to support or infrastructure, with steps to reproduce. Don't include real API keys. - [How do I use the Agent API safely in production?](https://help.clatterlabs.com/agent-api/safety-and-abuse/safe-use-of-agent-outputs): Keep keys on the server, give keys minimal permissions, filter end-user input, review outputs and never paste secrets. - [How does the abuse policy apply to the Agent API?](https://help.clatterlabs.com/agent-api/safety-and-abuse/abuse-policy-agent-api): Insulting or cursing at the assistant earns a warning, then a 24-hour pause on a second strike within 30 days. Key owners answer for end-user text. ### Teams and companies - [Can I build and sell a product on top of the Agent API?](https://help.clatterlabs.com/agent-api/teams-and-business/build-a-product-on-agent-api): Yes, within the Terms. You're responsible for your end users' text and for keeping keys server-side. - [Can my company use the Agent API?](https://help.clatterlabs.com/agent-api/teams-and-business/agent-api-for-companies): Yes. Companies use it from backends, CI and internal tools, with keys per service, team members on one plan and credit balance, and spending limits. - [How do I budget Agent API costs for a team or company?](https://help.clatterlabs.com/agent-api/teams-and-business/budgeting-agent-api-for-a-team): Measure a few representative runs, set per-member limits, top up credits on a schedule and monitor spend with GET /v1/account. - [How do I build a multi-user app on the Agent API?](https://help.clatterlabs.com/agent-api/teams-and-business/multi-tenant-app): Keep one server-side key, queue user requests, tag runs with user ids in metadata, filter input, and enforce per-user limits yourself. - [How do I use the Agent API in a CI pipeline?](https://help.clatterlabs.com/agent-api/teams-and-business/agent-api-in-ci): Store the key and Account ID as CI secrets, start a run from a job, stream or poll until done, then fail the job on failed runs. - [How do teams work with the Agent API?](https://help.clatterlabs.com/agent-api/teams-and-business/teams-and-agent-api): Team members use the owner's plan and credits, within access and limits the owner sets. Outside access answers 403 team_scope_denied. - [How is our data handled when we use the Agent API?](https://help.clatterlabs.com/agent-api/teams-and-business/data-handling-for-companies): Runs work on your account's cloud computer on Clatter Labs infrastructure. See the Privacy Policy and contact us for deletion or security questions. - [Is my Agent API data used to train models?](https://help.clatterlabs.com/agent-api/teams-and-business/data-for-training): The Agent API docs don't address training. Read the Privacy Policy and Terms, and email infrastructure@clatterlabs.xyz for a clear answer. - [Is there an uptime guarantee (SLA) for the Agent API?](https://help.clatterlabs.com/agent-api/teams-and-business/agent-api-sla): The docs don't publish an SLA. Live service health and incidents are on status.clatterlabs.com; contact us about business needs. - [Our security team needs details about the Agent API. Where do we start?](https://help.clatterlabs.com/agent-api/teams-and-business/vendor-security-review): Share the docs on keys, scopes and the abuse policy, plus the Privacy Policy and Terms. Email infrastructure@clatterlabs.xyz for more. - [Someone left our company. What should we do about Agent API keys?](https://help.clatterlabs.com/agent-api/teams-and-business/offboarding-employee-keys): Rotate any keys they could see, remove them from your team, and review recent runs and spend. ### Retired Cosmos Agent app - [agent.clatterlabs.com only shows "Cosmos Agent is now an API". Is something broken?](https://help.clatterlabs.com/agent-api/retired-app/agent-website-shows-notice): No. That notice replaced the retired web app. Use the Console and the Agent API docs instead. - [Can I get my old Cosmos Agent app chats and files back?](https://help.clatterlabs.com/agent-api/retired-app/old-app-conversations): The retired app doesn't open anymore. Email support with your Account ID to ask about earlier data, or infrastructure to have it deleted. - [Can Line CLI still hand jobs to Cosmos in the cloud?](https://help.clatterlabs.com/agent-api/retired-app/line-cli-delegation-removed): No. Line CLI 0.7.0-beta removed cloud delegation; sub-agents now run locally. Use the Agent API for cloud runs. - [How do I move from the Cosmos Agent app to the Agent API?](https://help.clatterlabs.com/agent-api/retired-app/move-from-app-to-api): Create a key in the Console, copy your Account ID, and send tasks as runs. Your account and credits carry over. - [I had scheduled or repeating tasks in the Cosmos Agent app. What happens to them?](https://help.clatterlabs.com/agent-api/retired-app/retired-app-scheduled-tasks): The app is retired, so its tasks don't run there. Recreate them with your own scheduler calling the Agent API. - [I still have the Cosmos Agent desktop app installed. What should I do?](https://help.clatterlabs.com/agent-api/retired-app/desktop-app-still-installed): The desktop app is retired. You can uninstall it and use the Agent API or Line CLI instead. Your account and credits stay the same. - [My bookmark to the Cosmos Agent app doesn't work. Where should it point?](https://help.clatterlabs.com/agent-api/retired-app/bookmarks-to-old-app): Old app pages no longer open the app. Bookmark the Console for keys and usage, and the docs for the Agent API. - [What happened to my credits when the app was retired?](https://help.clatterlabs.com/agent-api/retired-app/app-credits-after-retirement): Nothing. Your Clatter Labs account and credits stay the same, and credits now pay for Agent API and Model API usage. - [What happened to the Cosmos Agent app?](https://help.clatterlabs.com/agent-api/retired-app/cosmos-agent-app-retired): The Cosmos Agent desktop and web app were retired. Cosmos Agent lives on as the Cosmos Agent API, usable with Line CLI. - [Which app features do I get in the Agent API?](https://help.clatterlabs.com/agent-api/retired-app/app-features-in-the-api): The API runs the same Cosmos agent with its cloud computer: terminal, browser, Cloud Repos, hosting, storage, sub-agents and memory. - [Why did Clatter Labs turn Cosmos Agent into an API?](https://help.clatterlabs.com/agent-api/retired-app/why-was-the-app-retired): Cosmos Agent now focuses on being an AI agent API for coding, used from your own tools and with Line CLI. ## Line CLI Installing, signing in, commands, updates and troubleshooting for the Line coding CLI. ### Getting started - [Can I use Line CLI in Arabic?](https://help.clatterlabs.com/line/getting-started/line-in-arabic): Yes. Write to Line in Arabic: right-to-left text is shaped, ordered and right-aligned in answers and in the input box. /rtl changes the layout. - [Can I use Line CLI on a Chromebook?](https://help.clatterlabs.com/line/getting-started/chromebook): Yes, if your Chromebook has the Linux development environment turned on. Install Line inside it with the Linux installer. - [Can I use the Model API instead of Line CLI?](https://help.clatterlabs.com/line/getting-started/line-vs-model-api): The Model API gives your code direct access to SuperCosmos; Line CLI is a finished agent with tools, approvals and sessions built on the same model. - [Can kids or students use Line CLI?](https://help.clatterlabs.com/line/getting-started/kids-and-students): Students aged 13 and up can use Line CLI. Younger children can't have an account; teens may need a parent or guardian's consent. - [Can Line CLI break my computer?](https://help.clatterlabs.com/line/getting-started/can-line-break-my-computer): Line asks before changing files or running commands by default, keeps secrets protected and can undo its file edits. Read approvals carefully. - [Can Line CLI build a whole app or website for me?](https://help.clatterlabs.com/line/getting-started/can-line-make-a-website): Yes, Line can create a project from scratch, writing many files and running commands. Big builds work best with a plan and a clear check. - [Can Line CLI handle a very large codebase or monorepo?](https://help.clatterlabs.com/line/getting-started/big-codebases): Yes. Line uses a ranked repo map, search tools, a 1M-token context, auto-compaction and parallel sub-agents to work in large repositories. - [Does Line CLI work offline?](https://help.clatterlabs.com/line/getting-started/does-line-work-offline): No. Line CLI runs on your computer, but the SuperCosmos model runs on Clatter Labs infrastructure, so you need an internet connection. - [How do I start my first Line CLI session?](https://help.clatterlabs.com/line/getting-started/first-session): Install Line CLI, sign in once with line login, then run line inside your project folder to start chatting with the agent. - [How do I write good requests for Line CLI?](https://help.clatterlabs.com/line/getting-started/good-prompts): Tips for asking Line CLI for work: say the goal, name the files, give the check that proves it's done, and use plan mode for big jobs. - [How is Line CLI different from code autocomplete in my editor?](https://help.clatterlabs.com/line/getting-started/line-vs-autocomplete): Autocomplete suggests the next lines as you type. Line is an agent: it takes a whole task, works across files, runs commands and checks results. - [Is it called Line, Line CLI or Clatter Line?](https://help.clatterlabs.com/line/getting-started/line-name-meaning): The product is called Line CLI and the command you type is line. It is made by Clatter Labs. "Clatter Line" is not its name. - [Is Line CLI free to use?](https://help.clatterlabs.com/line/getting-started/is-line-free): Yes. Line CLI is covered by every Clatter Labs plan, including the Free plan, which has a monthly usage allowance. - [Is Line CLI open source?](https://help.clatterlabs.com/line/getting-started/is-line-open-source): No. Line CLI is distributed as a binary from install.clatterlabs.xyz. There's no public source repository to build from. - [Should I use Line CLI or the Cosmos Agent API?](https://help.clatterlabs.com/line/getting-started/line-vs-agent-api): Use Line CLI to work interactively on code on your own machine; use the Agent API to run Cosmos Agent from your own software over HTTPS. - [What am I looking at in the Line CLI screen?](https://help.clatterlabs.com/line/getting-started/interface-tour): A tour of the Line CLI terminal interface: the conversation, the input box, approvals, the Agents panel, the to-do panel and the status bar. - [What can't Line CLI do?](https://help.clatterlabs.com/line/getting-started/what-line-cant-do): Line can't see images, work offline, host or deploy your app for you, sandbox commands on Windows yet, or use models other than SuperCosmos. - [What do I need before installing Line CLI?](https://help.clatterlabs.com/line/getting-started/what-you-need): The requirements for Line CLI: a supported OS and CPU, a terminal, an internet connection and a free Clatter Labs account. - [What does Line CLI do, in simple words?](https://help.clatterlabs.com/line/getting-started/line-cli-explained-simply): A plain-language explanation of Line CLI for beginners: a helper in your terminal that can read and change code when you say yes. - [What is a coding agent?](https://help.clatterlabs.com/line/getting-started/what-is-a-coding-agent): A coding agent is an AI that can take actions on code: read files, make edits and run commands in steps until a task is done, not just chat. - [What is a prompt?](https://help.clatterlabs.com/line/getting-started/what-is-a-prompt): A prompt is the message you type to tell an AI what you want. In Line CLI, it's the request you write in the input box. - [What is a terminal, and how do I open one?](https://help.clatterlabs.com/line/getting-started/what-is-a-terminal): A terminal is a text window where you type commands. How to open one on Windows, macOS and Linux so you can install and run Line CLI. - [What is Line CLI?](https://help.clatterlabs.com/line/getting-started/what-is-line-cli): Line CLI is Clatter Labs' coding agent for your terminal. It reads and edits your project and runs commands with your approval. - [What is SuperCosmos, the model behind Line CLI?](https://help.clatterlabs.com/line/getting-started/what-is-supercosmos-in-line): SuperCosmos 1.1 by Clatter Labs is the model Line CLI uses: 550B parameters (55B active), a 1M-token context and three efforts. - [What's the difference between Line CLI and Cosmos on Telegram?](https://help.clatterlabs.com/line/getting-started/line-vs-telegram-bot): Line CLI works on code in your terminal with your local files; Cosmos on Telegram is a chat assistant on your phone or desktop Telegram app. - [Where can I learn more about Line CLI?](https://help.clatterlabs.com/line/getting-started/where-to-learn-more): Links to the Line CLI docs, commands reference, skills and plugins guides, changelog, status page and support. - [Which programming languages does Line CLI work with?](https://help.clatterlabs.com/line/getting-started/what-languages-does-line-support): Line CLI isn't tied to one language. It reads and edits any text files and runs your project's own build, test and lint commands. - [Who is Line CLI for?](https://help.clatterlabs.com/line/getting-started/who-is-line-for): Line CLI is for anyone who writes code in a terminal: hobbyists, students, professional developers and teams, on Windows, macOS and Linux. ### Install on Windows - [Can I install Line CLI for every user on a Windows PC?](https://help.clatterlabs.com/line/install-windows/install-for-all-users-windows): The installer is per-user: it installs to the current user's profile and updates that user's PATH. Each user runs the installer. - [Can I install Line CLI from Git Bash, MSYS or Cygwin on Windows?](https://help.clatterlabs.com/line/install-windows/git-bash-on-windows): The macOS/Linux install script stops on Git Bash, MSYS and Cygwin. Use the PowerShell installer instead; then line works in any terminal. - [Does Line CLI work on Windows on ARM?](https://help.clatterlabs.com/line/install-windows/windows-on-arm): Yes. On Windows on ARM devices the installer installs the x64 build of Line CLI, which runs under Windows' built-in emulation. - [Does the Line CLI sandbox work on Windows?](https://help.clatterlabs.com/line/install-windows/windows-sandbox): Not yet. The opt-in OS sandbox for shell commands works on Linux and macOS. On Windows, sandbox "on" refuses to run commands. - [How do I install Line CLI on Windows?](https://help.clatterlabs.com/line/install-windows/install-on-windows): Open PowerShell and run irm https://install.clatterlabs.xyz/line.ps1 | iex. Line installs to your user folder and is added to your PATH. - [How do I update Line CLI on Windows?](https://help.clatterlabs.com/line/install-windows/update-on-windows): Run line update in a terminal. On Windows, Line swaps the binary safely and keeps the previous one beside it until the next update. - [My antivirus or SmartScreen blocks line.exe. Is it safe?](https://help.clatterlabs.com/line/install-windows/antivirus-blocks-line): Security tools sometimes flag new command-line programs. The installer verifies every download's checksum; only install from install.clatterlabs.xyz. - [PowerShell blocks the Line CLI install script. What can I do?](https://help.clatterlabs.com/line/install-windows/execution-policy-error): If PowerShell refuses to run the installer because of its execution policy, allow scripts for the current session and run the command again. - [Which shell does Line CLI use to run commands on Windows?](https://help.clatterlabs.com/line/install-windows/windows-shell-commands): On Windows, Line CLI runs shell commands with PowerShell. On macOS and Linux it uses sh. Ask Line for PowerShell syntax if needed. - [Which Windows terminal works best with Line CLI?](https://help.clatterlabs.com/line/install-windows/windows-terminal-recommendation): Line CLI runs in PowerShell and Windows Terminal. A modern terminal with Unicode and mouse support gives the best experience. - [Why does Windows say "line is not recognized" after installing?](https://help.clatterlabs.com/line/install-windows/line-not-recognized-windows): PowerShell windows opened before the install don't see the updated PATH. Open a new terminal, or check that .line\bin is on your user PATH. ### Install on macOS - ["command not found: line" on macOS after installing](https://help.clatterlabs.com/line/install-macos/command-not-found-macos): Your shell hasn't loaded the new PATH yet. Restart Terminal or run the export line the installer printed, then check your profile file. - [Can I install Line CLI with Homebrew?](https://help.clatterlabs.com/line/install-macos/homebrew): There's no official Homebrew formula. Install Line CLI with the official script, which verifies checksums and can update itself. - [Does Line CLI run natively on Apple silicon Macs?](https://help.clatterlabs.com/line/install-macos/apple-silicon-vs-intel): Yes. Line CLI has native builds for Apple silicon (arm64) and Intel (x86_64) Macs, and the installer picks the right one. - [Does Line CLI work in iTerm2, VS Code's terminal and other Mac terminals?](https://help.clatterlabs.com/line/install-macos/macos-terminal-apps): Yes. Line CLI runs in any terminal on macOS, including Terminal, iTerm2 and editor terminals, as long as ~/.line/bin is on PATH. - [How do I install Line CLI on a Mac?](https://help.clatterlabs.com/line/install-macos/install-on-macos): Open Terminal and run curl -fsSL https://install.clatterlabs.xyz/line | sh. It works on Intel and Apple silicon Macs. - [How do I remove Line CLI from a Mac?](https://help.clatterlabs.com/line/install-macos/macos-uninstall-quick): Run line logout, delete ~/.line/bin/line, remove the Line CLI lines from ~/.zshrc, and optionally delete ~/.config/line and ~/.line. - [How does the Line CLI sandbox work on macOS?](https://help.clatterlabs.com/line/install-macos/macos-sandbox-seatbelt): On macOS, Line's opt-in sandbox uses the system's Seatbelt to confine shell commands' writes to the project, temp and tool-cache folders. - [macOS says Line CLI can't be opened or is from an unidentified developer](https://help.clatterlabs.com/line/install-macos/macos-security-warning): The installer removes macOS's quarantine flag. If you copied the binary manually, remove the flag yourself or reinstall with the script. - [Which shell profile does the Line installer change?](https://help.clatterlabs.com/line/install-macos/zsh-vs-bash-profile): The installer adds ~/.line/bin to PATH in ~/.zshrc (zsh), ~/.bashrc and ~/.bash_profile (bash on macOS), a fish conf.d file, or ~/.profile. ### Install on Linux - ["Line CLI doesn't support the … architecture yet"](https://help.clatterlabs.com/line/install-linux/unsupported-architecture): Line CLI has builds for x86_64 and aarch64 on Linux. Other CPUs, such as 32-bit ARM or x86, aren't supported yet. - [Can I run Line CLI in a Docker container?](https://help.clatterlabs.com/line/install-linux/install-in-docker): Yes. Install with the script inside the container (it needs curl or wget), sign in with line login --device, or run print mode for automation. - [Can I use Line CLI on a Raspberry Pi?](https://help.clatterlabs.com/line/install-linux/raspberry-pi): Yes, on a 64-bit OS. Line CLI has an aarch64 Linux build. 32-bit Raspberry Pi OS (armv7l) isn't supported. - [Do I need sudo or root to install Line CLI?](https://help.clatterlabs.com/line/install-linux/install-without-root): No. Line CLI installs into your home folder (~/.line/bin) and adds itself to your PATH without root. Don't run the installer with sudo. - [Does Line CLI work on Alpine and other musl-based Linux?](https://help.clatterlabs.com/line/install-linux/alpine-and-musl): Yes. Line CLI's Linux builds are static (musl), so they run on Alpine, Debian, Ubuntu, Fedora, Arch and most other distributions. - [How do I install and sign in to Line CLI on a server over SSH?](https://help.clatterlabs.com/line/install-linux/install-on-a-server): Install with the usual script, then sign in with line login --device: open the link on any device and confirm the code shown. - [How do I install Line CLI in WSL?](https://help.clatterlabs.com/line/install-linux/install-in-wsl): Inside your WSL Linux distribution, use the Linux installer. Sign in with line login, or line login --device if no browser opens. - [How do I install Line CLI on Linux?](https://help.clatterlabs.com/line/install-linux/install-on-linux): Run curl -fsSL https://install.clatterlabs.xyz/line | sh. Static builds run on x86_64 and aarch64 Linux, no root needed. - [How does the Line CLI sandbox work on Linux?](https://help.clatterlabs.com/line/install-linux/linux-sandbox): On Linux, Line's opt-in sandbox confines shell commands' writes to the project, temp and tool-cache folders, and can block network access. - [The Line installer says "curl or wget is required"](https://help.clatterlabs.com/line/install-linux/no-curl-or-wget): The install script downloads files with curl or wget. Install either one with your package manager, then run the installer again. ### The installer - [Can I run Line CLI from a USB drive or portable folder?](https://help.clatterlabs.com/line/installer/portable-install): Install into a folder with LINE_INSTALL_DIR and keep settings there with LINE_CONFIG_DIR. Treat the folder as private: it holds your sign-in. - [How do I install a specific version of Line CLI?](https://help.clatterlabs.com/line/installer/install-specific-version): Set LINE_VERSION before running the installer, for example LINE_VERSION=0.9.0-beta. Older versions may not be available. - [How do I install Line CLI in a CI pipeline?](https://help.clatterlabs.com/line/installer/install-in-ci): Install with the script and LINE_NO_MODIFY_PATH=1, add ~/.line/bin to PATH, pin LINE_VERSION if you want repeatable builds. - [How do I install Line CLI into a different folder?](https://help.clatterlabs.com/line/installer/custom-install-folder): Set LINE_INSTALL_DIR before running the installer to choose where the line binary goes instead of ~/.line/bin. - [How do I reinstall Line CLI?](https://help.clatterlabs.com/line/installer/reinstall-line): Run the install command again. It replaces the binary with the latest version and keeps your sign-in, settings and sessions. - [How do I stop the Line installer from changing my shell profile?](https://help.clatterlabs.com/line/installer/dont-modify-path): Run the macOS/Linux installer with LINE_NO_MODIFY_PATH=1 and it won't edit any profile file. Add ~/.line/bin to PATH yourself. - [How does the Line CLI installer work?](https://help.clatterlabs.com/line/installer/how-the-installer-works): The install script finds your OS and CPU, downloads the matching Line build, verifies its SHA-256 checksum and adds it to your PATH. - [Is it safe to pipe the install script into sh?](https://help.clatterlabs.com/line/installer/is-curl-pipe-sh-safe): The script is short and served over HTTPS from Clatter Labs. You can read it first, and it verifies the binary's checksum before installing. - [The installer fails on a company network with HTTPS inspection](https://help.clatterlabs.com/line/installer/ssl-inspection): HTTPS inspection proxies can break downloads or change files, causing checksum failures. Ask IT to exempt install.clatterlabs.xyz. - [The installer says "checksum mismatch". What should I do?](https://help.clatterlabs.com/line/installer/checksum-mismatch): A checksum mismatch means the download didn't match the official release, so nothing was installed. Retry on a reliable network. - [The Line installer can't connect from my office network](https://help.clatterlabs.com/line/installer/installer-behind-proxy): If the installer reports it couldn't reach install.clatterlabs.xyz, a firewall or proxy may block it. Allow the host or ask your IT team. - [What is install.clatterlabs.xyz?](https://help.clatterlabs.com/line/installer/install-page): install.clatterlabs.xyz is Clatter Labs' official download host for Line CLI: install scripts, release info and binaries. - [Where is Line CLI installed on my computer?](https://help.clatterlabs.com/line/installer/where-is-line-installed): The binary goes to ~/.line/bin (Windows: %USERPROFILE%\.line\bin). Settings and sessions are in ~/.config/line; skills and plugins in ~/.line. ### Updates and versions - [Can I go back to an older version of Line CLI?](https://help.clatterlabs.com/line/updates-and-versions/downgrade-line): You can try installing a specific version with LINE_VERSION, but older versions may be unavailable and can lack fixes. Latest is recommended. - [Do I need to restart Line CLI after updating?](https://help.clatterlabs.com/line/updates-and-versions/update-notice-restart): Yes. After line update or /update, quit Line and start it again so the new version runs. Your session is saved and can be continued. - [How do I check which version of Line CLI I have?](https://help.clatterlabs.com/line/updates-and-versions/check-my-version): Run line --version, or line status for version, build target, account and model. Inside Line, /status shows the same. - [How do I find out when a new Line CLI version is released?](https://help.clatterlabs.com/line/updates-and-versions/how-to-know-new-version): Line doesn't notify you inside the app. Run line update to check, or watch the changelog on developers.clatterlabs.com. - [How do I update Line CLI?](https://help.clatterlabs.com/line/updates-and-versions/update-line): Run line update (or /update inside Line). It downloads the latest release, verifies its checksum and replaces the binary. Then restart line. - [Line CLI release history](https://help.clatterlabs.com/line/updates-and-versions/release-history): A summary of every public Line CLI beta release, from 0.3.0-beta to 0.9.0-beta, with the main change in each. - [Line Code was retired. What does that mean for Line CLI?](https://help.clatterlabs.com/line/updates-and-versions/line-code-retired): Line Code, Clatter Labs' earlier coding model, was retired on Nov 1, 2026. Line CLI now runs on SuperCosmos 1.1, and nothing breaks. - [line update failed. How do I fix it?](https://help.clatterlabs.com/line/updates-and-versions/update-failed): Fixes for line update errors: no connection, checksum mismatch, and no permission to write next to the line binary. - [My script prints "Line Code was retired" on stderr. Do I need to change it?](https://help.clatterlabs.com/line/updates-and-versions/line-code-notice-in-scripts): Scripts that pass -m line-code still run, on SuperCosmos, with a one-line notice. Change them to -m supercosmos -e flash|max|heavy. - [What changed in Line CLI 0.9.0-beta?](https://help.clatterlabs.com/line/updates-and-versions/whats-new-in-0-9): Line CLI 0.9.0-beta (Nov 2, 2026) runs on SuperCosmos 1.1 only. Line Code is gone, and saved Line Code settings move to SuperCosmos. - [What does "beta" mean for Line CLI?](https://help.clatterlabs.com/line/updates-and-versions/beta-meaning): Line CLI is in beta: it's usable for real work but still changing quickly. Versions are marked -beta and features may change between releases. - [What happened to SuperCosmos 1.0 in Line CLI?](https://help.clatterlabs.com/line/updates-and-versions/supercosmos-1-0-in-line): SuperCosmos 1.1 replaced 1.0 on Nov 2, 2026. The same names and efforts now run 1.1, at the same prices. Nothing to change in Line. - [What happens if I keep using an older version of Line CLI?](https://help.clatterlabs.com/line/updates-and-versions/old-version-still-installed): Older Line versions may still connect, but miss fixes and may refer to retired features. Update with line update to get 0.9.0-beta. - [Where did /delegate and /conversations go?](https://help.clatterlabs.com/line/updates-and-versions/delegate-removed): Cosmos delegation (/delegate, /conversations, /tasks, /link) was removed in Line CLI 0.7.0-beta. Sub-agents now run the work locally. - [Which SuperCosmos effort replaces my Line Code setting?](https://help.clatterlabs.com/line/updates-and-versions/line-code-effort-mapping): Line Code Fast becomes SuperCosmos Flash, Ultra becomes Max and Ultra Fast becomes Heavy. No effort or auto becomes Flash. ### Signing in - [Can I sign in to Line CLI with GitHub?](https://help.clatterlabs.com/line/sign-in/sign-in-with-github): Line CLI signs in through your Clatter Labs account. If your account uses GitHub to sign in, choose it on the browser page that opens. - [Can I use Line CLI on more than one computer?](https://help.clatterlabs.com/line/sign-in/sign-in-on-several-computers): Yes. Install Line and run line login on each computer. All of them use the same account and plan; sessions stay on each machine. - [Can I use Line CLI without a Clatter Labs account?](https://help.clatterlabs.com/line/sign-in/use-without-account): No. Line needs you to sign in so usage counts toward your plan. The account and the Free plan are free. - [Do I need an API key to use Line CLI?](https://help.clatterlabs.com/line/sign-in/do-i-need-an-api-key): No. Line CLI uses your Clatter Labs account sign-in, not an API key. API keys are for the Model API, Agent API and Code Buckets API. - [Does Line CLI work with two-factor authentication?](https://help.clatterlabs.com/line/sign-in/two-factor-and-line): Yes. 2FA happens on the Clatter Labs sign-in page in your browser. Line only receives the approved sign-in afterwards. - [How do I get a Clatter Labs account for Line CLI?](https://help.clatterlabs.com/line/sign-in/create-account-for-line): Run line login and choose to create an account on the Clatter Labs sign-in page, or sign up first. The account and Free plan cost nothing. - [How do I sign in to Line CLI without a browser?](https://help.clatterlabs.com/line/sign-in/device-sign-in): Use line login --device (or /login device). Open the link it prints on any device, sign in and confirm the code to finish. - [How do I sign in to Line CLI?](https://help.clatterlabs.com/line/sign-in/sign-in-to-line): Run line login. Your browser opens to sign in with your Clatter Labs account; approve the Line CLI app once and Line remembers you. - [How do I sign out of Line CLI?](https://help.clatterlabs.com/line/sign-in/sign-out): Run line logout (or /logout). Line revokes its token and deletes it from your computer. Sign in again any time with line login. - [How does Line CLI store my sign-in on my computer?](https://help.clatterlabs.com/line/sign-in/is-my-sign-in-stored-safely): Line saves its sign-in in ~/.config/line/auth.json with private file permissions, never passes it to commands, and revokes it on logout. - [Line CLI says "your sign-in expired — run /login"](https://help.clatterlabs.com/line/sign-in/sign-in-expired): Line couldn't refresh its sign-in. Run /login (or line login) to sign in again; your session and settings are kept. - [Line CLI sign-in timed out waiting for the browser](https://help.clatterlabs.com/line/sign-in/browser-sign-in-timeout): Line waits 5 minutes for the browser sign-in. If it times out or the browser can't reach Line, run line login again or use --device. - [line login opens the wrong browser or browser profile](https://help.clatterlabs.com/line/sign-in/wrong-browser-profile): Copy the sign-in link Line prints into the browser you want, or use line login --device and open the link anywhere. - [Which Clatter Labs account is Line CLI signed in to?](https://help.clatterlabs.com/line/sign-in/which-account): Run line status or /status. The account line shows your email, name or Account ID, or "not signed in — run line login". ### Models and efforts - [Can Line CLI look at images or screenshots?](https://help.clatterlabs.com/line/models-and-efforts/can-line-see-images): No. SuperCosmos reads text only, so Line can't view images. Describe the screen in words, or share error text, logs or HTML instead. - [Do supercosmos-flash, supercosmos-max and supercosmos-heavy still work in Line CLI?](https://help.clatterlabs.com/line/models-and-efforts/older-supercosmos-ids): Yes. Line accepts the per-effort ids and converts them to SuperCosmos with that effort, for example supercosmos-heavy becomes effort heavy. - [How big is the context window in Line CLI?](https://help.clatterlabs.com/line/models-and-efforts/context-window-size): SuperCosmos 1.1 has a 1M-token context window (1,048,576 tokens). Line auto-compacts at about 80% of it and reserves room for the reply. - [How do I change the effort (Flash, Max, Heavy) in Line CLI?](https://help.clatterlabs.com/line/models-and-efforts/choose-effort): Type /effort to open the picker, or /effort flash, /effort max or /effort heavy. Use -e for a single run from the shell. - [How do I choose the model in Line CLI?](https://help.clatterlabs.com/line/models-and-efforts/choose-model): Type /model and pick Auto or SuperCosmos. Your choice becomes the default for future sessions. Then use /effort to pick Flash, Max or Heavy. - [How do I see which models Line CLI can use?](https://help.clatterlabs.com/line/models-and-efforts/list-models): Run line models. It lists Auto and SuperCosmos with their size, context window and each effort with a short description. - [How do I show or hide the model's thinking in Line CLI?](https://help.clatterlabs.com/line/models-and-efforts/thinking-display): Use /config thinking on or /config thinking off. The setting is saved and applies to future sessions too. - [How do I use a different model or effort for just one run?](https://help.clatterlabs.com/line/models-and-efforts/model-for-one-run): Start Line with -m and -e, for example line -m supercosmos -e heavy. It applies to that run only and doesn't change your saved default. - [Line CLI shows "Model busy · retrying in Ns". What does it mean?](https://help.clatterlabs.com/line/models-and-efforts/model-busy): When the model is very busy, Line waits and retries automatically, honouring the server's Retry-After. Your turn continues by itself. - [What does the "auto" model setting do in Line CLI?](https://help.clatterlabs.com/line/models-and-efforts/what-is-auto): Auto lets Line pick the SuperCosmos effort per step: Max for the first step and after failures, Flash for routine steps. It's the default. - [What's the difference between Flash, Max and Heavy?](https://help.clatterlabs.com/line/models-and-efforts/flash-max-heavy-difference): All three are SuperCosmos 1.1 with the same weights and 1M context. Flash is fastest, Max thinks before acting, Heavy thinks longest. - [Which effort should I use in Line CLI?](https://help.clatterlabs.com/line/models-and-efforts/which-effort-should-i-use): Start with Auto. Use Flash for speed on simple tasks, Max for multi-file changes and debugging, and Heavy for the hardest problems. ### Usage, plans and limits - [/cost shows dollars. Am I being charged that?](https://help.clatterlabs.com/line/usage-and-limits/cost-shown-is-not-a-charge): No. On a plan, /cost shows the list-price value of the session's tokens. That value counts toward plan limits; it isn't billed to your card. - [/usage says "Plan and limits unavailable right now"](https://help.clatterlabs.com/line/usage-and-limits/usage-unavailable): Line couldn't read your plan from the server. It still shows this session's numbers. Check your connection and sign-in, then try again. - [Do my credits pay for Line CLI?](https://help.clatterlabs.com/line/usage-and-limits/do-credits-pay-for-line): No. Line CLI is covered by your plan. Credits pay only for the Model API and Agent API. /usage shows your credit balance for reference. - [Do sub-agents use more of my plan?](https://help.clatterlabs.com/line/usage-and-limits/sub-agents-usage): Yes. Each sub-agent makes its own model calls, which count toward your plan. Parallel work finishes faster but uses more usage at once. - [Does /compact use my plan?](https://help.clatterlabs.com/line/usage-and-limits/compact-costs-usage): Yes, a little. /compact makes one call to SuperCosmos Flash to write the summary, which counts toward your plan. Later steps then send less. - [How can I make my Line CLI usage last longer?](https://help.clatterlabs.com/line/usage-and-limits/save-usage-tips): Use Flash for simple work, keep sessions focused, compact or start fresh when context is large, and give precise requests with file names. - [How do I cap how much a Line CLI run can spend?](https://help.clatterlabs.com/line/usage-and-limits/max-budget): In print mode, pass --max-budget-usd, for example line -p "task" --max-budget-usd 0.50. Line stops when the run's list-price spend reaches it. - [How do I check how much of my plan I've used in Line CLI?](https://help.clatterlabs.com/line/usage-and-limits/check-usage): Type /usage. It shows your plan, % used of each limit with the reset time, credits, Line usage for 7 days and cost per model. - [How do I upgrade my plan for more Line CLI usage?](https://help.clatterlabs.com/line/usage-and-limits/upgrade-from-line): Plans are changed in the Console under Billing › Plans. Line picks up the new limits automatically; check with /usage. - [How is Line CLI usage counted against my plan?](https://help.clatterlabs.com/line/usage-and-limits/how-line-is-billed): Each call is valued at the SuperCosmos rate of the effort it ran on, and that value counts toward your plan's limits, shared with Cosmos Agent. - [How much can I do with Line CLI on the Free plan?](https://help.clatterlabs.com/line/usage-and-limits/free-plan-line): The Free plan includes Line CLI with every effort and a monthly allowance that resets on the 1st (UTC). Paid plans give about 15× to 280× more. - [I'm on a team. Why does Line CLI say my access or quota is limited?](https://help.clatterlabs.com/line/usage-and-limits/team-member-limits): Team members use the owner's plan within limits the owner sets. Line may answer team_scope_denied, team_daily_quota_reached or team_spend_limit_reached. - [Line CLI says I've reached my plan's usage limit](https://help.clatterlabs.com/line/usage-and-limits/plan-limit-reached): You hit your usage window, weekly or monthly limit. Line shows when it resets. Wait for the reset or move to a bigger plan. - [What are cached tokens in /usage and /cost?](https://help.clatterlabs.com/line/usage-and-limits/cached-tokens): Cached tokens are input tokens that repeat from earlier steps. Line keeps history stable so they can be reused; /usage reports them. - [What is a usage window on paid plans?](https://help.clatterlabs.com/line/usage-and-limits/usage-window-explained): On paid plans, a usage window starts with your first request after the last one ended and lasts 5.5, 5, 2 or 1.5 hours depending on plan. - [What's the difference between /usage and /cost?](https://help.clatterlabs.com/line/usage-and-limits/usage-vs-cost): /cost shows tokens and list-price cost for the current session only. /usage adds your plan limits, credits and 7-day usage from your account. - [Why did one Line CLI request count more than usual?](https://help.clatterlabs.com/line/usage-and-limits/long-context-multiplier): Requests with more than 262K input tokens count their whole input at 1.5× the normal rate. Compacting keeps requests below that. - [Why does /usage say "unlimited"?](https://help.clatterlabs.com/line/usage-and-limits/enterprise-unlimited): Accounts on Clatter Labs' internal team plan show "unlimited" in /usage. That plan isn't for sale; normal plans show % used and resets. - [Why does /usage show "Line Code (retired)"?](https://help.clatterlabs.com/line/usage-and-limits/old-line-code-usage-rows): Usage from before Nov 1, 2026 on the retired Line Code model is labelled "Line Code (retired)" in /usage history, priced as billed then. - [Why does Line CLI sometimes wait, and is that a limit?](https://help.clatterlabs.com/line/usage-and-limits/rate-limited-vs-limit): Line waits in two cases: the model is briefly busy (it retries by itself) or your plan limit is reached (it shows a reset time). - [Why is my input token count so much bigger than output?](https://help.clatterlabs.com/line/usage-and-limits/input-bigger-than-output): Each step sends the conversation, file contents and tool results as input, while the reply is short. That's normal for coding agents. ### Commands and keys - [How do /sessions and /resume work?](https://help.clatterlabs.com/line/commands/sessions-resume-command): /sessions or /resume opens a picker of up to 15 recent sessions in this project folder, with title, age and message count. - [How do I attach a file to my message in Line CLI?](https://help.clatterlabs.com/line/commands/at-file-mentions): Type @ and start typing a file name, press Tab to complete, and send. Line attaches that project file. Secret and outside files are skipped. - [How do I change settings with /config?](https://help.clatterlabs.com/line/commands/config-command): /config shows your settings file and current values. /config auto on|off, /config thinking on|off and /config model change them. - [How do I change the approval mode with /mode?](https://help.clatterlabs.com/line/commands/mode-command): /mode ask, /mode accept-edits, /mode auto or /mode plan sets how much Line asks before acting. Shift+Tab cycles the same modes. - [How do I quit Line CLI?](https://help.clatterlabs.com/line/commands/exit-line): Type /exit (or /quit, /q), or press Ctrl+C when the input is empty. Your session is saved and background shells are stopped. - [How do I read the /context breakdown?](https://help.clatterlabs.com/line/commands/context-command): /context shows the window size, % used, and tokens for the system prompt, tools, your messages, replies, tool calls, results and free space. - [How do I reuse a prompt I typed earlier?](https://help.clatterlabs.com/line/commands/prompt-history): Press the up and down arrows in the input box to move through your prompt history. Line keeps it in ~/.config/line/history.jsonl. - [How do I see help inside Line CLI?](https://help.clatterlabs.com/line/commands/help-command): Type /help (or /?) for every command, key, mode and feature. From the shell, line --help shows flags and examples. - [How do I select and copy text in Line CLI?](https://help.clatterlabs.com/line/commands/mouse-command): With mouse scrolling on, hold Shift while dragging to select text. Or type /mouse off so your terminal handles the mouse normally. - [How do I start Line CLI with a task already typed?](https://help.clatterlabs.com/line/commands/start-with-prompt): Put the prompt after line in quotes, for example line "fix the failing test". Line starts and begins working on it right away. - [How do I stop Line CLI in the middle of a task?](https://help.clatterlabs.com/line/commands/interrupt-a-turn): Press Esc to interrupt the current turn. Nothing half-written is applied. Then type a new instruction, /undo changes, or continue. - [How do I use Line CLI with VS Code or another editor?](https://help.clatterlabs.com/line/commands/use-in-vs-code): Open your editor's built-in terminal in the project and run line. Edits appear in your editor; /diff and /files show what changed. - [How do I use plan mode (/plan) in Line CLI?](https://help.clatterlabs.com/line/commands/plan-command): /plan toggles plan mode: Line researches read-only and ends with a plan for you to approve. /plan turns it on and starts at once. - [How do I write a message with several lines in Line CLI?](https://help.clatterlabs.com/line/commands/multiline-input): Press Shift+Enter, Alt+Enter or Ctrl+J for a new line, or end a line with a backslash. Enter sends the message. - [How does /compact work in Line CLI?](https://help.clatterlabs.com/line/commands/compact-command): /compact summarizes the conversation (goal, decisions, files, commands, state, next steps) so work continues with a smaller context. - [What are commands like /guard:audit?](https://help.clatterlabs.com/line/commands/plugin-commands): Plugins add their own slash commands, named /:. They appear only while that plugin is enabled. - [What are the keyboard shortcuts in Line CLI?](https://help.clatterlabs.com/line/commands/keyboard-shortcuts): Line CLI keys: Enter to send, Shift+Enter for a new line, Esc to interrupt, Shift+Tab to change mode, Tab to complete, and scrolling keys. - [What commands does Line CLI have?](https://help.clatterlabs.com/line/commands/all-commands): A complete list of Line CLI slash commands: models, modes, changes, context, sessions, extensions, account and app commands. - [What does /auto do?](https://help.clatterlabs.com/line/commands/auto-command): /auto toggles auto-approve, so edits and commands run without asking. Secret files and reads outside the project still ask. - [What does /init do?](https://help.clatterlabs.com/line/commands/init-command): /init asks Line to study your project in plan mode and write LINE.md: a short guide to the codebase that Line follows in later sessions. - [What does /status show in Line CLI?](https://help.clatterlabs.com/line/commands/status-command): /status shows Line's version and build, your account, model, auto-approve state, project folder, instructions file and session id. - [What does /todos show?](https://help.clatterlabs.com/line/commands/todos-command): /todos shows the agent's current plan, the to-do list it keeps with todo_write, with each item's status: done, in progress or pending. - [What flags and subcommands does the line command accept?](https://help.clatterlabs.com/line/commands/all-flags): Every line command-line flag and subcommand: prompts, print mode, continue and resume, model and effort, permissions, sandbox, login and more. - [What's the difference between /new and /clear in Line CLI?](https://help.clatterlabs.com/line/commands/new-and-clear): Both start a fresh conversation and save the old session. /new also says "New session started." Neither deletes files or saved sessions. ### Permissions and safety - [Can Line CLI delete my files?](https://help.clatterlabs.com/line/permissions-and-safety/can-line-delete-files): Line can delete files with its delete_file tool or shell commands, but asks first in ask mode. /undo restores files it deleted with its own tools. - [Can Line CLI push to GitHub or deploy my code?](https://help.clatterlabs.com/line/permissions-and-safety/git-push-safety): Line's git tool is read-only. Pushing or deploying needs a shell command, which asks for approval unless you're in auto mode. - [Can Line CLI read files outside my project folder?](https://help.clatterlabs.com/line/permissions-and-safety/outside-project-folder): Only if you approve. Reads, lists and searches outside the working folder always ask, except temp folders and folders you allow with --add-dir. - [Does Line CLI hide my API keys and passwords from the model?](https://help.clatterlabs.com/line/permissions-and-safety/secret-redaction): Line replaces keys and tokens found in tool output with [REDACTED:kind] before sending it to the model. It's automated and not perfect. - [Does the model see my environment variables or secrets?](https://help.clatterlabs.com/line/permissions-and-safety/environment-variables-model): Only if a command prints them. Line's own sign-in token is never passed to commands, and secrets in tool output are redacted automatically. - [How do I approve or decline what Line CLI wants to do?](https://help.clatterlabs.com/line/permissions-and-safety/what-does-approve-mean): When Line asks, read the command or diff it shows, then approve or decline. Declining tells the agent no, and it tries another way or stops. - [How do I report a security problem in Line CLI?](https://help.clatterlabs.com/line/permissions-and-safety/report-security-issue): Email support@clatterlabs.com with the Line version, your OS and steps to reproduce. Don't post vulnerabilities publicly first. - [How do I set permission rules (allow, ask, deny) in Line CLI?](https://help.clatterlabs.com/line/permissions-and-safety/permission-rules): Add permissions with allow, ask and deny lists to ~/.config/line/settings.json, such as bash(npm test*) or read_file(.env*). Deny always wins. - [How do I stop Line CLI from editing certain files?](https://help.clatterlabs.com/line/permissions-and-safety/protect-a-folder): Add deny rules for edits on those paths, such as Edit(migrations/**), in your settings or the project's .line/settings.json. - [Is it safe to run Line CLI in auto mode?](https://help.clatterlabs.com/line/permissions-and-safety/run-everything-without-asking): Auto mode is convenient but lets Line run commands without asking. Use it in projects under version control, ideally with rules or the sandbox. - [Line CLI keeps asking me to approve the same command. How do I stop that?](https://help.clatterlabs.com/line/permissions-and-safety/stop-repeated-prompts): Add an allow rule for that command, like bash(npm test*), switch to accept edits mode for file changes, or use auto mode for trusted work. - [Should I run Line CLI on a production server?](https://help.clatterlabs.com/line/permissions-and-safety/production-servers): Be careful. Prefer a development copy. If you must, keep ask mode, use deny rules and the sandbox, and never use auto mode there. - [What are Line CLI's approval modes?](https://help.clatterlabs.com/line/permissions-and-safety/approval-modes): Line has four modes: ask (default), accept edits, auto and plan. They decide what Line does on its own and what waits for your OK. - [What does Line CLI send to Clatter Labs?](https://help.clatterlabs.com/line/permissions-and-safety/what-data-line-sends): Line sends your prompts, relevant file excerpts, command output and tool results to the model over an encrypted connection, plus version info. - [What is Line CLI's prompt-injection guard?](https://help.clatterlabs.com/line/permissions-and-safety/prompt-injection-guard): Web pages, search results and MCP output are treated as untrusted. If they contain instructions to the agent, edits and commands need approval. - [What is the dont-ask permission mode?](https://help.clatterlabs.com/line/permissions-and-safety/dont-ask-mode): In print mode, --permission-mode dont-ask declines anything that would need approval instead of waiting, so scripts never hang. - [Where can I see every command and edit Line CLI made?](https://help.clatterlabs.com/line/permissions-and-safety/audit-log): Line keeps an audit log of executed commands and edits (with secrets redacted) in ~/.config/line/audit/.jsonl on your computer. - [Why does Line CLI always ask before touching my .env file?](https://help.clatterlabs.com/line/permissions-and-safety/secret-files): Files that usually hold secrets, like .env, SSH and cloud credentials and private keys, always need your approval, even in auto mode. ### Sessions and context - [Can I rename a Line CLI session?](https://help.clatterlabs.com/line/sessions-and-context/rename-session): There's no rename command. A session's title is the start of its first prompt, shown in /resume. - [Can I share a Line CLI session with a teammate?](https://help.clatterlabs.com/line/sessions-and-context/share-a-session): Sessions are JSON files in ~/.config/line/sessions. You can send one, and they can open it with --resume, but it contains your code excerpts. - [How do I continue my last Line CLI session?](https://help.clatterlabs.com/line/sessions-and-context/continue-last-session): Run line -c in the same project folder to continue the most recent session there. It works with print mode too: line -c -p "continue". - [How do I delete my Line CLI history and sessions?](https://help.clatterlabs.com/line/sessions-and-context/delete-sessions): Delete files in ~/.config/line/sessions (sessions) and ~/.config/line/history.jsonl (prompt history) while Line isn't running. - [How do I resume a specific Line CLI session?](https://help.clatterlabs.com/line/sessions-and-context/resume-by-id): Use line --resume with the session id (a prefix is enough). Find ids in /resume, /status or at the end of print-mode runs. - [How do I see what Line CLI changed in my files?](https://help.clatterlabs.com/line/sessions-and-context/see-changes): /diff shows this session's changes (/diff split side by side, /diff for one file). /files lists changed files by turn and agent. - [How do I undo changes Line CLI made?](https://help.clatterlabs.com/line/sessions-and-context/undo-changes): Type /undo to revert the file changes of the last turn, or /rewind to go back to before an earlier prompt. Shell command effects aren't tracked. - [How does Line CLI remember things about my project?](https://help.clatterlabs.com/line/sessions-and-context/project-memory-linemd): Line reads LINE.md (or AGENTS.md) in your project and ~/.line/LINE.md at the start of every session. /init writes one for you. - [Line CLI closed unexpectedly. Did I lose my work?](https://help.clatterlabs.com/line/sessions-and-context/session-after-crash): No. Line saves the session after every step, on failure and on Ctrl+C. Run line -c in the same folder to continue. - [What is auto-compact in Line CLI?](https://help.clatterlabs.com/line/sessions-and-context/auto-compact): When the conversation fills about 80% of the context window, Line clears old tool output and summarizes if needed, so long tasks keep going. - [What's the difference between /undo and /rewind?](https://help.clatterlabs.com/line/sessions-and-context/rewind-explained): /undo reverts only the last turn's file changes and keeps the chat. /rewind goes back to before any earlier prompt, restoring files and cutting the chat. - [Where does Line CLI save my sessions?](https://help.clatterlabs.com/line/sessions-and-context/where-sessions-are-saved): Sessions are saved on your computer in ~/.config/line/sessions/.json, one file per session, private to your user. - [Why don't I see my session from another folder?](https://help.clatterlabs.com/line/sessions-and-context/sessions-per-folder): Line CLI groups sessions by project folder. line -c and /resume show sessions for the current folder; use --resume for others. ### Tools and sub-agents - [Can Line CLI edit Jupyter notebooks?](https://help.clatterlabs.com/line/tools-and-agents/notebooks): Yes. The notebook_edit tool replaces, inserts or deletes cells in .ipynb files. Line reads the notebook as JSON to find the right cell. - [Can Line CLI install packages or use tools like Docker?](https://help.clatterlabs.com/line/tools-and-agents/install-packages): Yes, through shell commands such as npm install or docker build, which ask for approval unless you allowed them. - [Can Line CLI make git commits for me?](https://help.clatterlabs.com/line/tools-and-agents/git-commits): Line's git tool is read-only, but it can commit with a shell command like git commit, which asks for approval unless allowed. - [Can Line CLI search the web and read documentation?](https://help.clatterlabs.com/line/tools-and-agents/web-tools): Yes. web_search finds pages and web_fetch reads them as text. Web content is treated as untrusted, so injected instructions trigger approvals. - [Can Line CLI use a web browser to test my site?](https://help.clatterlabs.com/line/tools-and-agents/no-browser-clicking): Line has no built-in browser. web_fetch reads pages as text. For browser testing, Line can run your own test tools like Playwright. - [Can two sub-agents edit the same file at once?](https://help.clatterlabs.com/line/tools-and-agents/parallel-edits): No. Line locks files per agent, requires a read before an edit, and refuses an edit if the file changed since that agent read it. - [How do background shells work in Line CLI?](https://help.clatterlabs.com/line/tools-and-agents/background-shells): Line runs dev servers and watchers in background shells. /bashes lists them, /bashes shows output, /bashes kill stops one. - [How do I create a custom sub-agent in Line CLI?](https://help.clatterlabs.com/line/tools-and-agents/custom-sub-agents): Add .line/agents/.md (or ~/.line/agents/.md) with front matter name, description, tools, model, effort, max_steps and instructions. - [How do I see what Line CLI's sub-agents did?](https://help.clatterlabs.com/line/tools-and-agents/agents-command): /agents lists this session's sub-agent runs with kind, state, steps, time, tokens and files. /agents shows one run's steps and report. - [How do I tell Line CLI which command checks my project?](https://help.clatterlabs.com/line/tools-and-agents/set-verify-command): Set verify_command in the project's .line/settings.json, for example "make check". Line runs it before finishing when files changed. - [How does Line CLI check for compile and type errors?](https://help.clatterlabs.com/line/tools-and-agents/diagnostics-tool): The diagnostics tool runs your project's own type checker, compiler or linter, detected from the project, and returns the errors. - [What are sub-agents in Line CLI?](https://help.clatterlabs.com/line/tools-and-agents/sub-agents): Sub-agents are extra agents Line starts on your machine to explore, research, review or do work in parallel, then report back. - [What happens when a command prints a huge amount of output?](https://help.clatterlabs.com/line/tools-and-agents/long-command-output): Output over about 30 KB is saved to a file. The agent gets the path plus the beginning and end, with more of the end when the command failed. - [What is the repo map in Line CLI?](https://help.clatterlabs.com/line/tools-and-agents/repo-map): The repo map is a ranked outline of your codebase: the most central files with their functions, types and classes, built with tree-sitter. - [What tools can Line CLI use?](https://help.clatterlabs.com/line/tools-and-agents/what-tools): Line's built-in tools cover files, search, shell, git, diagnostics, a repo map, notebooks, the web, a to-do plan, sub-agents and skills. - [Why does Line CLI keep going when the model tries to stop early?](https://help.clatterlabs.com/line/tools-and-agents/auto-continue): If the model stops before the work is done, with open to-dos, a promise and no action, or an empty reply, Line tells it to continue. - [Why does Line CLI run my tests before it finishes?](https://help.clatterlabs.com/line/tools-and-agents/verification): When Line changed files, it checks the work before finishing: your verify_command, else your tests, else your type checker. Failures go back to the agent. - [Why does Line CLI write long files in several parts?](https://help.clatterlabs.com/line/tools-and-agents/big-file-writes): Very large single writes can be cut in transit. Line writes big files in parts of about 120 lines with append_file, and redoes cut steps. ### Configuration and extensions - [Can a project have its own Line CLI settings?](https://help.clatterlabs.com/line/configuration/project-settings): Yes. A project's .line/settings.json can add ask and deny permission rules, a verify_command and hooks. It can never allow more. - [Does Line CLI read AGENTS.md or CLAUDE.md files?](https://help.clatterlabs.com/line/configuration/agents-md-support): Line follows LINE.md or AGENTS.md in the project. /status also detects CLAUDE.md as an instructions file in the folder. - [How do I add an MCP server to Line CLI?](https://help.clatterlabs.com/line/configuration/add-mcp-server): Add the server to ~/.line/mcp.json (yours) or .mcp.json in the project under mcpServers, with a command or a URL. Then /mcp reload. - [How do I create my own Line CLI plugin?](https://help.clatterlabs.com/line/configuration/create-plugin): Run line plugin new to scaffold an enabled plugin, edit plugin.json to add tools, commands, hooks or skills, then re-enable after changes. - [How do I give Line CLI instructions for every project?](https://help.clatterlabs.com/line/configuration/global-instructions): Write them in ~/.line/LINE.md. Line follows it in every session, together with the project's own LINE.md or AGENTS.md. - [How do I install and enable a Line CLI plugin?](https://help.clatterlabs.com/line/configuration/plugins): Install with line plugin install , review with line plugin info, then enable. Plugins stay off until you enable them. - [How do I keep Line CLI's settings in a different folder?](https://help.clatterlabs.com/line/configuration/config-dir-portable): Set LINE_CONFIG_DIR to a folder path. Line then stores sign-in, settings, sessions and logs there instead of ~/.config/line. - [How do I let Line CLI read a folder outside my project?](https://help.clatterlabs.com/line/configuration/additional-dirs): Add the folder with --add-dir for one run, or additional_dirs in settings.json to allow it always, without approval prompts. - [How do I make Line CLI show diffs side by side?](https://help.clatterlabs.com/line/configuration/diff-view-setting): Type /diff split for one view, or set "diff_view": "split" in settings.json to make side-by-side the default. - [How do I use hooks in Line CLI?](https://help.clatterlabs.com/line/configuration/hooks): Hooks run your scripts on PreToolUse, PostToolUse, UserPromptSubmit, Stop and SessionStart. Exit code 2 from a hook blocks the action. - [How do I use skills in Line CLI?](https://help.clatterlabs.com/line/configuration/skills): Skills are folders with a SKILL.md that teach Line a procedure. Install with line skill install, list with line skill list, or let the agent propose one. - [How do I write a LINE.md for my project?](https://help.clatterlabs.com/line/configuration/line-md): LINE.md is a Markdown file of project instructions Line follows every session. Run /init to draft one, then edit it and commit it. - [My MCP server shows "failed" in Line CLI](https://help.clatterlabs.com/line/configuration/mcp-failed): A failed MCP server couldn't start or connect. Check its command or URL, environment variables and tokens, then run /mcp reload. - [My MCP server shows "not trusted". How do I fix it?](https://help.clatterlabs.com/line/configuration/mcp-not-trusted): Servers defined in a project's .mcp.json don't start until you trust them. Run /mcp trust or line mcp trust . - [What can I put in Line CLI's settings.json?](https://help.clatterlabs.com/line/configuration/settings-file): Line's settings file ~/.config/line/settings.json holds model, effort, auto-approve, thinking, mouse, RTL, diff, repo map, verify, sandbox and permissions. - [What's the difference between hooks, plugins, skills and MCP in Line CLI?](https://help.clatterlabs.com/line/configuration/hooks-vs-plugins): Hooks run your scripts at events, plugins bundle tools/commands/hooks/skills, skills are instructions, and MCP connects external tool servers. - [Where does Line CLI search for skills, and are there limits?](https://help.clatterlabs.com/line/configuration/skill-limits-and-sources): Skill search defaults to the anthropics/skills GitHub repo; add sources with skill_sources or LINE_SKILL_SOURCES. Each skill: 60 files, 2 MB max. - [Which environment variables does Line CLI use?](https://help.clatterlabs.com/line/configuration/environment-variables): Environment variables for the Line installer (LINE_VERSION, LINE_INSTALL_DIR, LINE_NO_MODIFY_PATH) and for Line itself (LINE_CONFIG_DIR and more). - [Why did my Line CLI plugin turn itself off?](https://help.clatterlabs.com/line/configuration/plugin-disabled-after-change): Line disables a plugin when any of its files change after you enabled it. Review the change and enable it again. ### Scripting and automation - [Can I pipe text into Line CLI?](https://help.clatterlabs.com/line/scripting-and-automation/pipe-into-line): Put the text in the prompt, for example line -p "summarize: $(cat notes.txt)". Line reads the prompt from its arguments, not stdin. - [Can I run Line CLI on a schedule?](https://help.clatterlabs.com/line/scripting-and-automation/cron-schedule): Yes. Call line -p from cron or another scheduler on a signed-in machine, with dont-ask permissions, a turn limit and JSON output. - [Can print mode edit files without approving every change?](https://help.clatterlabs.com/line/scripting-and-automation/headless-accept-edits): Yes. --permission-mode accept-edits lets file edits run while commands are declined; --yes or auto lets everything run. - [How do I allow or block tools for one Line CLI run?](https://help.clatterlabs.com/line/scripting-and-automation/allowed-tools-flags): Use --allowed-tools for rules that run without asking and --disallowed-tools for rules that are denied. A bare tool name removes the tool. - [How do I limit how many steps a Line CLI run takes?](https://help.clatterlabs.com/line/scripting-and-automation/max-turns): Pass --max-turns N in print mode. Line stops after N model steps, exits with code 2 and saves the session so you can continue. - [How do I read Line CLI's JSON output from a script?](https://help.clatterlabs.com/line/scripting-and-automation/parse-json-python): Run line -p with --output-format json, parse the final line as JSON, and check subtype, is_error and result. - [How do I run Line CLI in print mode for scripts?](https://help.clatterlabs.com/line/scripting-and-automation/print-mode): line -p "prompt" answers once and exits: the answer on stdout, tool activity on stderr, with a usage line and an exit code. - [How do I use Line CLI in GitHub Actions or another CI system?](https://help.clatterlabs.com/line/scripting-and-automation/line-in-ci): Install Line in a step, run print mode with JSON output, limit permissions and turns, and read the exit code. Sign-in needs care on CI. - [How does --output-format stream-json work?](https://help.clatterlabs.com/line/scripting-and-automation/stream-json): stream-json prints one JSON event per line as Line works: init, text, tool_use, tool_result, usage, retry, note, permission_denied, then result. - [My Line CLI print-mode run failed. How do I continue it?](https://help.clatterlabs.com/line/scripting-and-automation/continue-failed-run): Print-mode runs are saved as sessions. Continue with line -c -p "continue" in the same folder, or line --resume -p "continue". - [What does Line CLI's JSON output look like?](https://help.clatterlabs.com/line/scripting-and-automation/json-output): With --output-format json, print mode ends with one result object: result, session id, steps, duration, tokens, cost, edits and status. - [What exit codes does Line CLI return?](https://help.clatterlabs.com/line/scripting-and-automation/exit-codes): Line exits 0 on success, 1 on error, 2 when --max-turns stopped it, and 130 when interrupted with Ctrl+C. Sessions are saved in every case. ### Troubleshooting - ["Permission denied" when running line on macOS or Linux](https://help.clatterlabs.com/line/troubleshooting/permission-denied-running-line): The binary may have lost its execute permission or sit on a noexec mount. Reinstall, or run chmod +x ~/.line/bin/line. - [/undo says "Nothing to undo"](https://help.clatterlabs.com/line/troubleshooting/nothing-to-undo): /undo only reverts changes Line made with its file tools in the current session. Shell command changes and earlier sessions aren't tracked. - [A hook is blocking Line CLI's actions](https://help.clatterlabs.com/line/troubleshooting/hook-blocks-everything): A hook that exits with code 2 blocks the action and gives its stderr as the reason. Check /hooks and fix or remove the hook. - [How do abuse policy warnings and pauses appear in Line CLI?](https://help.clatterlabs.com/line/troubleshooting/got-a-warning): In Line, a warning appears as a message and your request is still answered. A second strike in 30 days pauses the account for 24 hours. - [How do I know if Line CLI is down for everyone?](https://help.clatterlabs.com/line/troubleshooting/is-line-down): Check status.clatterlabs.com for incidents affecting Line CLI and SuperCosmos, subscribe to alerts, or use the RSS feed. - [I can't scroll up in Line CLI](https://help.clatterlabs.com/line/troubleshooting/cant-scroll): Use the mouse wheel or PgUp/PgDn. If the wheel scrolls your terminal instead, turn mouse capture on with /mouse on. - [I updated, but line --version still shows the old version](https://help.clatterlabs.com/line/troubleshooting/line-runs-old-version): You probably have two copies of line, or didn't restart. Check which binary runs with which line (or Get-Command line on Windows). - [Line CLI has trouble with a Windows folder that has spaces](https://help.clatterlabs.com/line/troubleshooting/windows-path-spaces): Quote paths with spaces in commands. If an install folder path causes problems, reinstall into a folder without spaces using LINE_INSTALL_DIR. - [Line CLI ignores my settings.json](https://help.clatterlabs.com/line/troubleshooting/settings-ignored): If settings.json has a JSON error, Line uses defaults. Validate the file, check you edited ~/.config/line/settings.json, and restart Line. - [Line CLI is working in the wrong folder](https://help.clatterlabs.com/line/troubleshooting/wrong-folder): Line works in the folder you start it in. Quit, cd into the right project and run line again, or allow extra folders with --add-dir. - [Line CLI keeps ignoring my project rules](https://help.clatterlabs.com/line/troubleshooting/agent-ignores-instructions): Put rules in LINE.md (or AGENTS.md) in the project root, keep them short and specific, and back hard rules with permission rules. - [Line CLI made changes I don't want. How do I recover?](https://help.clatterlabs.com/line/troubleshooting/agent-made-a-mess): Use /undo for the last turn, /rewind to go back further, and git for anything shell commands changed. Then give clearer limits. - [Line CLI says "--print needs a prompt"](https://help.clatterlabs.com/line/troubleshooting/print-needs-prompt): Print mode requires a prompt after -p. Write line -p "your request", or to continue a session, line -c -p "continue". - [Line CLI says " isn't available"](https://help.clatterlabs.com/line/troubleshooting/model-not-available): Line runs on auto and supercosmos only. Old model names (except line-code, which is mapped) are rejected. Use -m supercosmos -e . - [Line CLI says "Can't reach the Line API"](https://help.clatterlabs.com/line/troubleshooting/cant-reach-line-api): Line can't connect to Clatter Labs. Check your internet, VPN, proxy or firewall, then retry. Your session is saved. - [Line CLI says "Compact failed"](https://help.clatterlabs.com/line/troubleshooting/compact-failed): The summary call didn't complete, usually a connection or capacity issue. Your conversation is unchanged; try /compact again shortly. - [Line CLI says "Paused after 300 steps in one turn"](https://help.clatterlabs.com/line/troubleshooting/paused-after-steps): A single turn is capped at 300 model steps. Say "continue" to keep going; consider splitting the task or using plan mode first. - [Line CLI says "The connection to the Line API dropped mid-reply"](https://help.clatterlabs.com/line/troubleshooting/connection-dropped-mid-reply): A reply was cut off in transit. Line normally redoes the step by itself. If it keeps happening, check your network or the status page. - [Line CLI says "The Line API is temporarily unreachable"](https://help.clatterlabs.com/line/troubleshooting/temporarily-unreachable): Clatter Labs' service answered with a temporary gateway error (502–504). Line retries automatically; check the status page if it persists. - [Line CLI says "The Line API took too long to answer"](https://help.clatterlabs.com/line/troubleshooting/line-api-took-too-long): The request timed out. Line retries steps automatically; if you see this as a final error, try again or check the status page. - [Line CLI says "The model returned an empty response"](https://help.clatterlabs.com/line/troubleshooting/empty-response): The model answered with nothing several times. Line normally nudges it to continue; if it stops, rephrase, compact or switch effort. - [Line CLI says a command was declined. Why?](https://help.clatterlabs.com/line/troubleshooting/command-declined): In print mode, anything needing approval is declined unless allowed. Interactively, a deny rule or your own "no" can decline it. - [Line CLI says the context is full or older steps are clipped](https://help.clatterlabs.com/line/troubleshooting/out-of-context): The conversation is too long for the context window. Run /compact, start a new session, or remove large tool outputs and plugins you don't need. - [Line CLI seems stuck on "Thinking". What should I do?](https://help.clatterlabs.com/line/troubleshooting/stuck-thinking): Max and Heavy can think for a while on hard steps. Watch the status line for retries; press Esc to interrupt if it's taking too long. - [Line CLI shows a 401 or "not signed in" error during a session](https://help.clatterlabs.com/line/troubleshooting/401-unauthorized): Line refreshes its sign-in automatically once on a 401. If that fails, run /login to sign in again; your session is kept. - [Line CLI shows a 402 or credits error](https://help.clatterlabs.com/line/troubleshooting/402-error): Line usage is covered by your plan, not credits. A 402 isn't retried; check /usage and the Console billing page, then contact support. - [Line CLI takes a long time to start](https://help.clatterlabs.com/line/troubleshooting/slow-startup): Startup can wait for MCP servers to connect and for project scanning. Check slow MCP servers with line mcp, and disable ones you don't need. - [Line CLI's file edit failed. Why?](https://help.clatterlabs.com/line/troubleshooting/edit-failed): Edits fail when the text to replace isn't found exactly once or the file changed. Line shows the closest lines and usually retries itself. - [Line CLI's screen looks garbled or has strange symbols](https://help.clatterlabs.com/line/troubleshooting/garbled-display): Fix broken symbols, colours or layout in Line CLI by using a Unicode font, a modern terminal, resizing the window, or adjusting /rtl and /mouse. - [Line CLI's verification step keeps failing](https://help.clatterlabs.com/line/troubleshooting/verification-keeps-failing): Line runs your tests or verify_command before finishing. If the check is wrong or flaky, set verify_command or change verify to nudge or off. - [Line CLI's web_fetch returns almost nothing from a page](https://help.clatterlabs.com/line/troubleshooting/web-fetch-empty-page): Pages built with JavaScript return an empty shell. Line reports the title, links and asset URLs and suggests other ways to get the content. - [line skill install fails](https://help.clatterlabs.com/line/troubleshooting/skill-install-fails): Skill installs fail on bad sources, GitHub rate limits or skills over 60 files or 2 MB. Check the source, set GITHUB_TOKEN, or pick a smaller skill. - [My build fails with the Line CLI sandbox turned on](https://help.clatterlabs.com/line/troubleshooting/sandbox-blocks-build): The sandbox only lets commands write to the project, temp and tool-cache folders. Add needed folders to sandbox_writable or allow network. - [My MCP server's tools don't appear in Line CLI](https://help.clatterlabs.com/line/troubleshooting/mcp-tools-missing): Check /mcp: the server must be trusted (project servers) and ready. Fix failures, then /mcp reload. Tools appear as mcp__server__tool. - [Pressing Esc doesn't stop Line CLI right away](https://help.clatterlabs.com/line/troubleshooting/esc-doesnt-stop): Esc interrupts at the next safe point; a running shell command may need a moment. Press Ctrl+C to interrupt harder, again to exit. - [Shift+Enter sends my message instead of adding a new line](https://help.clatterlabs.com/line/troubleshooting/shift-enter-sends): Some terminals don't pass Shift+Enter through. Use Ctrl+J or Alt+Enter for a new line, or end the line with a backslash. - [The browser says sign-in failed when I run line login](https://help.clatterlabs.com/line/troubleshooting/sign-in-browser-error): If the sign-in page errors or the terminal never finishes, run line login again, use --device, or check your account can sign in on the website. - [What information should I send support about a Line CLI problem?](https://help.clatterlabs.com/line/troubleshooting/collect-info-for-support): Send line status output, your OS, what you ran, the exact error text, the time with time zone, and the session id if you have one. ### Privacy, data and uninstalling - [Can I use Line CLI on my company's private code?](https://help.clatterlabs.com/line/privacy-and-uninstall/line-and-company-code): Check your company's policy first. Line sends excerpts of what it reads to Clatter Labs models; controls like deny rules and the sandbox help. - [Does Clatter Labs use my code from Line CLI to train models?](https://help.clatterlabs.com/line/privacy-and-uninstall/does-line-train-on-my-code): Clatter Labs may use pseudonymized prompts and outputs, with secrets filtered, to train its own models. You can object with a privacy request. - [Does Line CLI collect analytics or telemetry?](https://help.clatterlabs.com/line/privacy-and-uninstall/telemetry): Line sends what the model needs for your task plus the CLI version and OS type. The audit log and sessions stay on your device. - [Does Line CLI upload my whole project?](https://help.clatterlabs.com/line/privacy-and-uninstall/is-my-code-uploaded): No. Line reads files only when a task needs them and sends just those excerpts, command output and tool results to the model. - [How do I permanently delete all my Line CLI data?](https://help.clatterlabs.com/line/privacy-and-uninstall/delete-everything): Delete Line's local folders yourself, then delete your Clatter Labs account or email infrastructure@clatterlabs.xyz to remove server-side data. - [How do I remove all skills, plugins and MCP servers from Line CLI?](https://help.clatterlabs.com/line/privacy-and-uninstall/remove-skills-plugins): Use line skill remove and line plugin remove, delete servers from ~/.line/mcp.json, or delete the ~/.line folders to clear everything. - [How do I uninstall Line CLI?](https://help.clatterlabs.com/line/privacy-and-uninstall/uninstall-line): Sign out with line logout, delete ~/.line/bin/line, remove the PATH line from your profile, and optionally delete ~/.config/line and ~/.line. - [What data does Line CLI keep on my computer?](https://help.clatterlabs.com/line/privacy-and-uninstall/where-is-my-data): Line keeps sign-in, settings, sessions, prompt history, audit logs, sub-agent run records and stats in ~/.config/line, all private to your user. ### Teams and business use - [Can a team owner see what members do in Line CLI?](https://help.clatterlabs.com/line/teams-and-business/admin-visibility): Owners see usage attributed per member in the Console's logs and usage pages. Sessions and prompts are stored on each member's own computer. - [Can my company use Line CLI commercially?](https://help.clatterlabs.com/line/teams-and-business/business-terms): Yes, under Clatter Labs' Terms of Service. Line CLI is in beta. For company agreements or data questions, contact infrastructure@clatterlabs.xyz. - [Can several people use Line CLI on one shared computer?](https://help.clatterlabs.com/line/teams-and-business/shared-machine): Yes, if each person uses their own OS user account. Sign-in and sessions are per OS user; sharing one OS account shares the sign-in. - [Does Clatter Labs offer enterprise agreements for Line CLI?](https://help.clatterlabs.com/line/teams-and-business/enterprise-agreements): For enterprise terms, data processing agreements or infrastructure questions, contact infrastructure@clatterlabs.xyz. Teams work on regular plans. - [How can my company give employees access to Line CLI?](https://help.clatterlabs.com/line/teams-and-business/buy-for-employees): The owner picks a plan, invites employees in Console › Team, and gives them Line CLI access with optional quotas. Each signs in with their own account. - [How do I control how much my team uses Line CLI?](https://help.clatterlabs.com/line/teams-and-business/control-team-spend): Set each member's daily quota and monthly limit in Console › Team. Members over their limit get team_daily_quota_reached or team_spend_limit_reached. - [How do I give a team member access to Line CLI?](https://help.clatterlabs.com/line/teams-and-business/give-member-line-access): As team owner, open Console › Team and include Line CLI in that member's access. Set a daily quota or monthly limit if you want. - [How do I make Line CLI follow the same rules for my whole team?](https://help.clatterlabs.com/line/teams-and-business/standardize-team-rules): Commit LINE.md and .line/settings.json with ask/deny rules and a verify_command. Project rules can restrict, never loosen, permissions. - [How do teams use Line CLI?](https://help.clatterlabs.com/line/teams-and-business/line-for-teams): Team members sign in with their own accounts and run on the owner's plan through Console Teams, with per-member access and limits. ## Cosmos on Telegram What Cosmos can do on Telegram: memory, reminders, persona, limits and safety. ### Getting started - [Can Cosmos write code for me in Telegram?](https://help.clatterlabs.com/telegram/getting-started/write-code-in-telegram): Yes. Cosmos writes code and sends it as a file saved to your Code Buckets. It can't run the code; use Line CLI to work on real projects. - [Can I add Cosmos to a Telegram group?](https://help.clatterlabs.com/telegram/getting-started/groups-not-supported): No. Cosmos on Telegram only works in private one-to-one chats. Messages in groups and channels are ignored. - [Can I build my own Telegram bot with SuperCosmos?](https://help.clatterlabs.com/telegram/getting-started/build-own-bot): Yes, with the Model API: your bot sends user messages to SuperCosmos with your API key. You're responsible for your users' text. - [Can I use Cosmos on Telegram for my business or customers?](https://help.clatterlabs.com/telegram/getting-started/business-use-telegram): The bot is a personal assistant for your own account. To build AI into products for customers, use the Model API or the Cosmos Agent API. - [Can I use Cosmos on Telegram with my class?](https://help.clatterlabs.com/telegram/getting-started/for-teachers): Each student needs their own Clatter Labs account (13+) and links their own Telegram. A Console team can put students on one plan. - [Can I use Cosmos to help with homework?](https://help.clatterlabs.com/telegram/getting-started/homework-help): Yes, to learn: ask it to explain topics, check your reasoning or quiz you. Follow your school's rules about AI and check facts. - [Do I need a Telegram account to use Cosmos?](https://help.clatterlabs.com/telegram/getting-started/what-is-telegram): Yes. Cosmos on Telegram is a Telegram bot, so you need the Telegram app and account, plus a free Clatter Labs account to sign in. - [Does Cosmos know about today's news?](https://help.clatterlabs.com/telegram/getting-started/news-and-current-events): Cosmos can search the web and read pages, so it can look up recent news and events. Ask for sources to check them yourself. - [Does Cosmos on Telegram work on my phone and computer?](https://help.clatterlabs.com/telegram/getting-started/devices): Yes. It works anywhere Telegram works: Android, iPhone, desktop and web. Your chats and reminders follow your Telegram account. - [How do I know I'm talking to the official Cosmos bot?](https://help.clatterlabs.com/telegram/getting-started/official-bot): The only official bot is @Cosmos_agents_bot. Sign-in links open telegram.clatterlabs.com and then the Clatter Labs sign-in page. - [How do I see everything Cosmos on Telegram can do?](https://help.clatterlabs.com/telegram/getting-started/help-command): Send /help. It lists the bot's abilities and commands. The command menu next to the message box shows the same commands. - [How do I start using Cosmos on Telegram?](https://help.clatterlabs.com/telegram/getting-started/start-using-the-bot): Open @Cosmos_agents_bot in Telegram, press Start, sign in with your Clatter Labs account using the button, and start chatting. - [How fast does Cosmos on Telegram answer?](https://help.clatterlabs.com/telegram/getting-started/how-fast): Simple questions usually come back in seconds. Research, files, images and screenshots take longer because Cosmos uses tools first. - [Is Cosmos on Telegram free?](https://help.clatterlabs.com/telegram/getting-started/is-it-free): Yes. It's included in every Clatter Labs plan, Free included. Usage counts toward your plan, and there's also a daily limit per account. - [Is Cosmos on Telegram the same as the old Cosmos Agent app?](https://help.clatterlabs.com/telegram/getting-started/cosmos-agent-app-retired): The Cosmos Agent web app was retired and became the Cosmos Agent API. Cosmos on Telegram is a separate, current way to chat with Cosmos. - [Should I use Cosmos on Telegram or Line CLI?](https://help.clatterlabs.com/telegram/getting-started/telegram-vs-line): Use Telegram for chat, research, reminders, images and quick tasks on any device. Use Line CLI for coding on files on your own computer. - [What is Cosmos on Telegram, in simple words?](https://help.clatterlabs.com/telegram/getting-started/cosmos-explained-simply): A friendly explanation for beginners: Cosmos is a smart helper you chat with in Telegram. It answers questions and can remind you of things. - [What is Cosmos on Telegram?](https://help.clatterlabs.com/telegram/getting-started/what-is-cosmos-on-telegram): Cosmos Agent on Telegram is Clatter Labs' AI agent inside Telegram: chat, research, files, images, screenshots, reminders and memory. - [What kinds of things can I ask Cosmos on Telegram?](https://help.clatterlabs.com/telegram/getting-started/what-can-i-ask): Examples of requests Cosmos on Telegram handles: questions, research, writing, code, images, screenshots, reminders, weather and memory. - [What should I try first with Cosmos on Telegram?](https://help.clatterlabs.com/telegram/getting-started/first-message-ideas): Five quick things to try in your first minutes with Cosmos on Telegram: set your time zone, a reminder, a memory, a photo and a screenshot. - [Which AI model does Cosmos on Telegram use?](https://help.clatterlabs.com/telegram/getting-started/which-model): Cosmos on Telegram runs on SuperCosmos by Clatter Labs, version 1.1, using the fast Flash effort. - [Who made Cosmos on Telegram?](https://help.clatterlabs.com/telegram/getting-started/who-made-cosmos): Cosmos Agent is made by Clatter Labs, a software studio building AI-native developer tools. It runs on Clatter Labs' own SuperCosmos models. ### Signing in and linking - [Can I link more than one Telegram account to my Clatter Labs account?](https://help.clatterlabs.com/telegram/sign-in-and-linking/several-telegram-accounts): Yes, up to 3 Telegram accounts per Clatter Labs account. They share memory, settings, files and the daily limit. - [How do I disconnect Cosmos on Telegram from my Clatter Labs account settings?](https://help.clatterlabs.com/telegram/sign-in-and-linking/disconnect-from-account): In your Clatter Labs account center, open Connected apps and disconnect Cosmos Agent (Telegram). The bot signs you out on your next message. - [How do I sign out of Cosmos on Telegram?](https://help.clatterlabs.com/telegram/sign-in-and-linking/sign-out): Send /logout and tap Sign out. Your Telegram is unlinked, chat history and pending reminders are removed; your files stay in Code Buckets. - [How do I switch Cosmos on Telegram to a different Clatter Labs account?](https://help.clatterlabs.com/telegram/sign-in-and-linking/switch-clatter-account): Send /logout, then /start and sign in with the other Clatter Labs account. Mind the 15-hour limit for new sign-in links. - [How does signing in to Cosmos on Telegram work?](https://help.clatterlabs.com/telegram/sign-in-and-linking/how-linking-works): Tap Sign in with Clatter Labs, open the page, sign in to Clatter Labs and confirm the code shown matches. Then return to Telegram. - [I don't have a Clatter Labs account. Can I still use the bot?](https://help.clatterlabs.com/telegram/sign-in-and-linking/no-clatter-account): You need one, but it's free. Tap Sign in with Clatter Labs in the bot and create an account on the sign-in page, then confirm the code. - [I think someone linked their Telegram to my Clatter Labs account](https://help.clatterlabs.com/telegram/sign-in-and-linking/someone-else-linked): Disconnect Cosmos Agent (Telegram) in Connected apps, change your password, turn on 2FA and contact support. - [My Cosmos sign-in link says it has expired](https://help.clatterlabs.com/telegram/sign-in-and-linking/link-expired): Sign-in links work once and expire after 30 minutes. Send /start for a new one; you can get a new link once every 15 hours. - [The bot says "I can't confirm your Clatter Labs sign-in right now"](https://help.clatterlabs.com/telegram/sign-in-and-linking/cant-confirm-sign-in): Cosmos couldn't check your sign-in because of a brief account service problem. Wait a minute and send your message again. - [The bot says "Sign-in didn't finish on our side, sorry"](https://help.clatterlabs.com/telegram/sign-in-and-linking/didnt-finish): The link was confirmed but linking didn't complete on Clatter Labs' side. Send /start for a fresh link; no 15-hour wait in this case. - [The bot says "Sign-in was cancelled on the Clatter Labs page"](https://help.clatterlabs.com/telegram/sign-in-and-linking/sign-in-cancelled): The request was denied on the Clatter Labs page. Send /start to get your link again and confirm the code this time. - [The code on the Clatter Labs page doesn't match the one in the link page](https://help.clatterlabs.com/telegram/sign-in-and-linking/code-doesnt-match): Don't confirm if the codes differ. Close the page, send /start in the bot and use the newest link only. - [The sign-in page says "Too many sign-in attempts" or "Busy right now"](https://help.clatterlabs.com/telegram/sign-in-and-linking/too-many-attempts): Limits protect sign-in from abuse. Wait an hour if your network made too many attempts, or a few minutes if many people are signing in. - [What happens if I change my Telegram username or phone number?](https://help.clatterlabs.com/telegram/sign-in-and-linking/telegram-account-changed): Nothing. Cosmos links to your Telegram account itself, not your username or phone number, so the link keeps working. - [Why do I have to sign in to use Cosmos on Telegram?](https://help.clatterlabs.com/telegram/sign-in-and-linking/why-sign-in): Signing in links your Telegram to your Clatter Labs account, so usage counts toward your plan and your files, memory and reminders are yours. - [Why do I have to wait 15 hours for a new sign-in link?](https://help.clatterlabs.com/telegram/sign-in-and-linking/fifteen-hour-cooldown): To prevent abuse, each Telegram account can get one new sign-in link every 15 hours, including after /logout. The bot shows the wait time. - [Why was I signed out of Cosmos on Telegram?](https://help.clatterlabs.com/telegram/sign-in-and-linking/signed-out-unexpectedly): You're signed out if the connection was removed in Connected apps, you signed out everywhere, your account was deleted or the sign-in expired. ### Chatting and commands - [Am I talking to a real person on Cosmos?](https://help.clatterlabs.com/telegram/chatting-and-commands/is-cosmos-a-person): No. Cosmos is an AI agent by Clatter Labs. It's friendly and may joke, but it's honest that it isn't human. - [Can Cosmos answer questions about Clatter Labs products?](https://help.clatterlabs.com/telegram/chatting-and-commands/clatter-labs-questions): Yes. Cosmos has built-in Clatter Labs knowledge, can look things up in the developer docs and can check live service status. - [Can Cosmos change my plan or answer questions about my account?](https://help.clatterlabs.com/telegram/chatting-and-commands/account-questions): Cosmos shows your usage with /usage and can explain plans, but it can't change your plan, billing or account settings. Use the Console. - [Can Cosmos check if a website is working?](https://help.clatterlabs.com/telegram/chatting-and-commands/is-a-website-down): Yes. Ask it to open or screenshot a public site. For Clatter Labs services, it can check the live status page. - [Can Cosmos on Telegram run code or programs?](https://help.clatterlabs.com/telegram/chatting-and-commands/can-cosmos-run-code): No. Cosmos on Telegram can write code and files, search the web and use its built-in tools, but it doesn't execute code. - [Can Cosmos read pages that need a login?](https://help.clatterlabs.com/telegram/chatting-and-commands/sites-behind-login): No. Cosmos reads only public pages. Pages behind a login, paywall or private network show only what a logged-out visitor sees. - [Can Cosmos reply with voice messages?](https://help.clatterlabs.com/telegram/chatting-and-commands/cosmos-voice-replies): No. Cosmos replies with text, plus files, images, screenshots and short GIF recordings. It doesn't send voice messages. - [Can Cosmos send emails or messages for me?](https://help.clatterlabs.com/telegram/chatting-and-commands/draft-messages): Cosmos can draft emails and messages for you to copy and send yourself. It can't send email or message other people on your behalf. - [Can Cosmos tell me the time and weather?](https://help.clatterlabs.com/telegram/chatting-and-commands/time-and-weather): Yes. Ask "what time is it in Tokyo?" or "weather in Cairo". Weather includes current conditions and a 3-day forecast. - [Can Cosmos translate text for me?](https://help.clatterlabs.com/telegram/chatting-and-commands/translate): Yes. Paste text or send a photo of it and say which language you want. Cosmos translates and can explain tone or idioms. - [Can Cosmos watch a video or summarize a YouTube link?](https://help.clatterlabs.com/telegram/chatting-and-commands/video-links): Cosmos can't watch videos. It can read the text on a public page, like a title and description, but not the video's audio or frames. - [Can I forward a message to Cosmos?](https://help.clatterlabs.com/telegram/chatting-and-commands/forwarded-messages): Yes. Forwarded text, photos and files are read like anything you send. Add your question in a follow-up message. - [Can I practise a new language with Cosmos?](https://help.clatterlabs.com/telegram/chatting-and-commands/learn-a-language): Yes. Ask Cosmos to chat with you in the language, correct your mistakes, quiz you on words or explain grammar simply. - [Can I reply to a specific earlier message to give Cosmos context?](https://help.clatterlabs.com/telegram/chatting-and-commands/reply-to-earlier-message): Cosmos reads your new message's text, not which earlier message it replies to. Quote or mention the part you mean. - [Can I send voice messages, stickers or videos to Cosmos?](https://help.clatterlabs.com/telegram/chatting-and-commands/voice-messages): Not yet. Cosmos handles text, photos and files (documents). For voice, type your message instead; for video, describe it or share a link. - [Can I trust Cosmos with math and calculations?](https://help.clatterlabs.com/telegram/chatting-and-commands/math-and-numbers): Cosmos is good at explaining math and doing everyday calculations, but it has no calculator tool. Double-check important numbers. - [Can I trust everything Cosmos tells me?](https://help.clatterlabs.com/telegram/chatting-and-commands/accuracy): Cosmos tries to be honest and uses web search for current facts, but AI can be wrong. Check important information, especially health, money and law. - [Cosmos says "I hit my step limit for one message"](https://help.clatterlabs.com/telegram/chatting-and-commands/step-limit): Cosmos does up to 12 steps (searches, tool uses) per message. Reply "continue" and it carries on from where it stopped. - [Cosmos says "Something went wrong on my side"](https://help.clatterlabs.com/telegram/chatting-and-commands/something-went-wrong): An unexpected error stopped the answer. Send your message again; if it keeps happening, try /new and check the status page. - [Cosmos's answer was cut off by a connection problem](https://help.clatterlabs.com/telegram/chatting-and-commands/answer-cut-off): If a connection problem cuts an answer twice, Cosmos ends it with a note. Say "continue" and it picks up from there. - [Do I need Telegram Premium to use Cosmos?](https://help.clatterlabs.com/telegram/chatting-and-commands/telegram-premium): No. Cosmos on Telegram works the same with a free Telegram account. What matters is your Clatter Labs plan and the bot's daily limit. - [Does Cosmos read links I paste automatically?](https://help.clatterlabs.com/telegram/chatting-and-commands/pasted-links): Cosmos decides when to open a link based on your message. Say "read this link" or ask a question about it to be sure it opens it. - [How do I get Cosmos to research something on the web?](https://help.clatterlabs.com/telegram/chatting-and-commands/web-research): Ask a question about anything current and ask for sources. Cosmos searches, reads the best pages and answers with links. - [How do I start a new conversation with Cosmos?](https://help.clatterlabs.com/telegram/chatting-and-commands/new-conversation): Send /new. Cosmos starts a fresh conversation without the earlier messages. Memories, reminders, files and settings stay. - [How do I stop Cosmos in the middle of an answer?](https://help.clatterlabs.com/telegram/chatting-and-commands/stop-an-answer): Tap the Stop button under the "Thinking…" message, or send /stop. Cosmos stops after the current step and shows "⏹ Stopped." - [How much of our conversation does Cosmos remember?](https://help.clatterlabs.com/telegram/chatting-and-commands/how-much-it-remembers-in-chat): Cosmos uses the most recent messages of the current conversation (about the last 24) as context. /new starts over. Long-term memory is separate. - [If I edit a message I sent, does Cosmos see the change?](https://help.clatterlabs.com/telegram/chatting-and-commands/edit-sent-message): No. Cosmos answers the message as you first sent it. To correct something, send a new message with the fix. - [Is there a limit to how long my message can be?](https://help.clatterlabs.com/telegram/chatting-and-commands/long-text-input): Telegram limits the length of one text message. For long text, send it as a file (for example .txt or .md) and ask about it. - [The bot says "I don't know that command"](https://help.clatterlabs.com/telegram/chatting-and-commands/unknown-command): That command doesn't exist in Cosmos on Telegram. Send /help for the list, or just write your request in normal words. - [What commands does Cosmos on Telegram have?](https://help.clatterlabs.com/telegram/chatting-and-commands/all-commands): Every Cosmos on Telegram command: /start, /new, /reminders, /memory, /forget, /name, /timezone, /files, /usage, /help, /stop and /logout. - [What do the emoji status lines in Cosmos's replies mean?](https://help.clatterlabs.com/telegram/chatting-and-commands/status-lines): While working, Cosmos shows what it's doing: searching, reading, writing files, creating images, screenshotting, reminders and memory. - [What happens if I send several messages quickly?](https://help.clatterlabs.com/telegram/chatting-and-commands/send-several-messages): Cosmos answers messages in order, one at a time. Extra messages wait in a short queue. For one request, send it as one message. - [Why does Cosmos split its answer into several messages?](https://help.clatterlabs.com/telegram/chatting-and-commands/long-answers): Telegram limits how long one message can be. Cosmos splits long answers into several messages so nothing is cut. - [Why does Cosmos's answer change while I'm reading it?](https://help.clatterlabs.com/telegram/chatting-and-commands/how-answers-appear): Cosmos shows "Thinking…", then status lines for tools, then writes the answer into the same message as it's generated. ### Images, screenshots and recordings - [Are the images Cosmos makes or I send private?](https://help.clatterlabs.com/telegram/images-and-websites/images-are-public): Photos and images are stored with an unguessable public image link, so anyone with that exact link can open them. Other files stay private. - [Are there limits on images in Cosmos on Telegram?](https://help.clatterlabs.com/telegram/images-and-websites/image-limits): Images count toward the daily token limit. Photos up to 10 MB are analyzed; Telegram lets bots download files up to 20 MB. - [Can Cosmos compare two photos?](https://help.clatterlabs.com/telegram/images-and-websites/compare-photos): Send the photos one after another, then ask your comparison question. Cosmos can look at each saved image again to answer. - [Can Cosmos edit or change a photo I send?](https://help.clatterlabs.com/telegram/images-and-websites/edit-a-photo): Not directly. Cosmos can look at your photo and create a new image from a description, but it doesn't edit the original pixels. - [Can Cosmos look at an image from a link?](https://help.clatterlabs.com/telegram/images-and-websites/image-from-a-link): Yes. Send a public image URL (PNG, JPEG, WebP or GIF) and ask about it. Private or local network addresses can't be opened. - [Can Cosmos read the text in a photo or screenshot?](https://help.clatterlabs.com/telegram/images-and-websites/read-text-in-image): Yes. Send the photo and ask Cosmos to read, copy or translate the text in it. It works for signs, documents, menus and screenshots. - [Can Cosmos record a video of a website?](https://help.clatterlabs.com/telegram/images-and-websites/website-recording): Yes. Ask to record a site and Cosmos sends a short animated GIF scrolling down the page, 2 to 12 seconds long (6 by default). - [Can Cosmos understand photos I send?](https://help.clatterlabs.com/telegram/images-and-websites/send-a-photo): Yes. Send a photo (JPEG, PNG or WebP up to 10 MB), with or without a question. Cosmos looks at it, reads text in it and answers. - [Cosmos couldn't screenshot a website](https://help.clatterlabs.com/telegram/images-and-websites/screenshot-failed): Screenshots fail for private or local addresses, sites that block automated browsers, very slow pages, or when today's limit is nearly used. - [Cosmos didn't look at the photo I sent](https://help.clatterlabs.com/telegram/images-and-websites/photo-not-analyzed): Automatic analysis covers JPEG, PNG and WebP photos up to 10 MB. HEIC, very large or other formats are saved but may not be analyzed. - [How do I get a screenshot of a website from Cosmos?](https://help.clatterlabs.com/telegram/images-and-websites/website-screenshot): Ask "screenshot example.com". Cosmos opens it in a real browser and sends a PNG. Ask for mobile or full-page versions too. - [How do I make Cosmos create an image?](https://help.clatterlabs.com/telegram/images-and-websites/create-an-image): Describe the picture you want, with subject, style and mood. Cosmos generates it, sends it as a photo and saves it to your Code Buckets. - [How do I use Cosmos to check how my website looks on mobile?](https://help.clatterlabs.com/telegram/images-and-websites/screenshot-my-own-site): Ask for a mobile screenshot or a mobile recording of your public site. Cosmos uses a phone-sized 390 × 844 viewport. - [My website screenshot shows a cookie banner or popup](https://help.clatterlabs.com/telegram/images-and-websites/screenshot-cookie-banner): Cosmos opens sites as a new visitor, so cookie banners and popups often appear. Try a specific page, the mobile view, or a recording. - [The text in my generated image is misspelled or garbled](https://help.clatterlabs.com/telegram/images-and-websites/text-in-generated-images): Image generation often struggles with exact words. Keep text short, or make the image without text and add words yourself. - [What styles of images can Cosmos create?](https://help.clatterlabs.com/telegram/images-and-websites/image-styles): Describe any style: photo-realistic, watercolor, cartoon, pixel art, flat design, 3D, sketch. Detailed prompts give better results. ### Files, PDFs and documents - [Can Cosmos open zip files or other binary files?](https://help.clatterlabs.com/telegram/files-and-documents/zip-and-binary-files): No. Cosmos stores them but can only read text, code, PDF and Office documents, and look at images. Unzip and send the files inside. - [Can Cosmos read and summarize a PDF?](https://help.clatterlabs.com/telegram/files-and-documents/read-a-pdf): Yes. Send the PDF as a file or paste a link to it, and ask for a summary, key points or answers. Cosmos converts it to text first. - [Can Cosmos read Word, Excel and PowerPoint files?](https://help.clatterlabs.com/telegram/files-and-documents/read-office-files): Yes. Cosmos reads .docx, .xlsx, .xls, .ods, .odt and .pptx files, sent as files or by link, by converting them to text. - [Can Cosmos use a file I sent earlier?](https://help.clatterlabs.com/telegram/files-and-documents/use-earlier-file): Yes. Files stay in your Code Buckets, so ask "use the budget.csv I sent yesterday". Cosmos lists your files and reads the right one. - [Cosmos says my file is over 20 MB](https://help.clatterlabs.com/telegram/files-and-documents/file-too-big): Telegram lets bots download files up to 20 MB. Compress or split the file, or upload it to Code Buckets and share a link. - [Do Cosmos on Telegram files count toward my Code Buckets storage?](https://help.clatterlabs.com/telegram/files-and-documents/storage-counts): Yes. Files you send and files Cosmos makes are stored in your Code Buckets and count toward your plan's storage. - [Do my files disappear if I sign out of Cosmos on Telegram?](https://help.clatterlabs.com/telegram/files-and-documents/files-after-logout): No. Files stay in your Code Buckets (project Cosmos Agent, bucket telegram) after /logout. Delete them in the Console if you want. - [How do I delete a file in Cosmos on Telegram?](https://help.clatterlabs.com/telegram/files-and-documents/delete-a-file): Ask Cosmos to delete it and tap Allow when it asks. The file is deleted from your Code Buckets for good. You can also delete it in the Console. - [How do I get Cosmos to make a file?](https://help.clatterlabs.com/telegram/files-and-documents/files-cosmos-makes): Ask for a file: "Write this as a Markdown file" or "Give me a CSV". Cosmos creates it, sends it in the chat and saves it to Code Buckets. - [How do I get Cosmos to read a scanned document?](https://help.clatterlabs.com/telegram/files-and-documents/scanned-documents): Send the pages as photos. Cosmos reads text in images. Scanned PDFs may not convert to text well. - [How do I see my files in Cosmos on Telegram?](https://help.clatterlabs.com/telegram/files-and-documents/files-command): Send /files. Cosmos lists your 10 newest files, whether you sent them or it made them, and whether each is shared or private. - [How do I send a file to Cosmos?](https://help.clatterlabs.com/telegram/files-and-documents/send-a-file): Attach a file as a document in Telegram, with a question if you like. Cosmos saves it to your Code Buckets and can read it. - [How do I share a file from Cosmos on Telegram?](https://help.clatterlabs.com/telegram/files-and-documents/share-a-file): Send /files and tap Share next to the file, or ask Cosmos to share it and tap Allow. You get a public link anyone can open. - [What is the "Cosmos Agent (Telegram)" API key in my Console?](https://help.clatterlabs.com/telegram/files-and-documents/revoke-telegram-key): It's a key the bot uses to store your files in your Code Buckets, limited to reading and writing buckets. It's revoked when you unlink. - [Where are my Cosmos on Telegram files stored?](https://help.clatterlabs.com/telegram/files-and-documents/where-files-are-stored): In your own Code Buckets: project "Cosmos Agent", bucket "telegram", created the first time you send or receive a file. - [Why does Cosmos ask me to Allow before sharing or deleting files?](https://help.clatterlabs.com/telegram/files-and-documents/approval-buttons): Making a file public and deleting a file can't be easily undone, so Cosmos always asks first with Allow and Deny buttons. ### Reminders and time zones - [Can Cosmos be a quick timer?](https://help.clatterlabs.com/telegram/reminders-and-time-zones/minutes-reminders): Yes. Say "remind me in 15 minutes" and Cosmos sends a message when the time is up. Reminders are checked every minute. - [Can Cosmos remind another person?](https://help.clatterlabs.com/telegram/reminders-and-time-zones/reminder-for-someone-else): No. Reminders are sent only to you, in your own chat with Cosmos. The other person can set their own reminders with the bot. - [Can Cosmos send a reminder every day or every week?](https://help.clatterlabs.com/telegram/reminders-and-time-zones/repeating-reminders): Yes. Say "every day at 8 remind me to drink water" or "every Monday at 9…". Daily and weekly repeats keep the same local time. - [Can I set reminders in Arabic?](https://help.clatterlabs.com/telegram/reminders-and-time-zones/reminders-in-arabic): Yes. Ask in Arabic, like "فكرني بكرة الساعة ٩ أتصل بأحمد". Cosmos understands and confirms in Arabic. - [Can I snooze a reminder?](https://help.clatterlabs.com/telegram/reminders-and-time-zones/snooze): Yes. Tap "⏰ +10 min" on the reminder message and Cosmos reminds you again in 10 minutes. - [Cosmos says "I don't know that time zone"](https://help.clatterlabs.com/telegram/reminders-and-time-zones/unknown-time-zone): Use a standard zone name like Africa/Cairo or Europe/Berlin, not an abbreviation like EST, or simply tell Cosmos your city. - [Cosmos says the reminder time is in the past](https://help.clatterlabs.com/telegram/reminders-and-time-zones/reminder-in-past): You can't set a one-off reminder for a time that's already passed. Give a future date and time, or check your time zone with /timezone. - [Do Cosmos reminders handle daylight saving time?](https://help.clatterlabs.com/telegram/reminders-and-time-zones/dst): Yes. Reminders are stored with your time zone, and daily or weekly repeats keep the same local time across daylight saving changes. - [How do I cancel a reminder?](https://help.clatterlabs.com/telegram/reminders-and-time-zones/cancel-a-reminder): Send /reminders and tap Cancel next to it, tap Stop repeating on a repeating reminder, or ask Cosmos "cancel my water reminder". - [How do I change a reminder's time or text?](https://help.clatterlabs.com/telegram/reminders-and-time-zones/edit-a-reminder): Reminders can't be edited. Cancel the old one in /reminders and set a new one with the right time or wording. - [How do I see my reminders?](https://help.clatterlabs.com/telegram/reminders-and-time-zones/list-reminders): Send /reminders. Cosmos lists up to 20 upcoming reminders with their time, repeat and text, plus a Cancel button for each. - [How do I set a reminder with Cosmos on Telegram?](https://help.clatterlabs.com/telegram/reminders-and-time-zones/set-a-reminder): Just ask in plain words, like "remind me tomorrow at 9 to call Ahmed". Cosmos confirms the exact time and sends the reminder as a message. - [How do I set my time zone in Cosmos on Telegram?](https://help.clatterlabs.com/telegram/reminders-and-time-zones/set-time-zone): Send /timezone with a zone name like /timezone Europe/London, or just tell Cosmos where you live. Reminders use it from then on. - [How many reminders can I have, and how far ahead?](https://help.clatterlabs.com/telegram/reminders-and-time-zones/reminder-limits): Up to 50 pending reminders per account, set up to 2 years ahead. Reminder text can be up to 500 characters. - [I'm travelling. How do I keep my reminders on the right time?](https://help.clatterlabs.com/telegram/reminders-and-time-zones/travel-time-zone): Tell Cosmos where you are, or use /timezone. New reminders use the new zone; existing reminders keep the zone they were set in. - [My reminder didn't arrive. Why?](https://help.clatterlabs.com/telegram/reminders-and-time-zones/reminder-didnt-arrive): Check the time zone, that Cosmos confirmed the reminder, that you didn't sign out or block the bot, and your Telegram notifications. - [What can I use Cosmos reminders for?](https://help.clatterlabs.com/telegram/reminders-and-time-zones/reminder-ideas): Ideas for reminders with Cosmos on Telegram: medicine, water, study sessions, bills, meetings, birthdays and weekly reports. - [What happens to my reminders if I sign out?](https://help.clatterlabs.com/telegram/reminders-and-time-zones/reminders-after-logout): /logout cancels pending reminders for that Telegram account. Set them again after you sign back in. - [What time zone does Cosmos use if I don't set one?](https://help.clatterlabs.com/telegram/reminders-and-time-zones/default-time-zone): Until you set yours, Cosmos uses Africa/Cairo. Set your own with /timezone or by telling Cosmos where you are. ### Memory - [Can I turn off Cosmos's memory?](https://help.clatterlabs.com/telegram/memory/memory-off): There's no off switch, but you can tell Cosmos not to remember things, delete single memories, or erase everything with /forget. - [Can Line CLI or other Clatter Labs products see my Telegram memories?](https://help.clatterlabs.com/telegram/memory/memory-in-other-products): Memories are used by Cosmos on Telegram. They're included in your account data export and deleted with your account. - [Can other people see what Cosmos remembers about me?](https://help.clatterlabs.com/telegram/memory/memory-private): No. Memories belong to your Clatter Labs account and are used only in your own chats. Other users can't see or query them. - [Cosmos didn't remember something I told it](https://help.clatterlabs.com/telegram/memory/why-didnt-it-remember): Cosmos saves durable facts, but not everything. Say "remember that…" to be sure, then check /memory. Only relevant memories are recalled. - [Cosmos remembered something wrong. How do I fix it?](https://help.clatterlabs.com/telegram/memory/memory-wrong): Tell Cosmos the correct fact ("I moved to Alexandria"), or delete the wrong memory with /memory and the 🗑 button. - [Does /forget delete anyone else's memories?](https://help.clatterlabs.com/telegram/memory/forget-only-mine): No. /forget only deletes the memories of the Clatter Labs account linked to the Telegram account that sent it. - [Does Cosmos keep my memories after I sign out?](https://help.clatterlabs.com/telegram/memory/memory-after-logout): Yes. Memories belong to your Clatter Labs account, so /logout doesn't erase them. Use /forget before signing out to delete them. - [Does Cosmos's memory work in Arabic and other languages?](https://help.clatterlabs.com/telegram/memory/memory-languages): Yes. Memory search is multilingual, so memories saved in Arabic or other languages are recalled when relevant, whatever language you write in. - [How do I make Cosmos forget one thing?](https://help.clatterlabs.com/telegram/memory/forget-one-thing): Send /memory and tap the 🗑 button next to it, or tell Cosmos "forget that I live in Cairo". - [How do I permanently delete everything Cosmos remembers about me?](https://help.clatterlabs.com/telegram/memory/forget-everything): Send /forget and tap "Delete permanently". Every memory and its search index is erased for good. Chats, files and reminders stay. - [How do I see what Cosmos remembers about me?](https://help.clatterlabs.com/telegram/memory/see-memories): Send /memory. Cosmos lists its newest memories about you, numbered, with a button to forget each one. - [How do I tell Cosmos to remember something?](https://help.clatterlabs.com/telegram/memory/remember-something): Say "remember that…" followed by the fact. Cosmos saves it as a short note and uses it in future conversations. - [How does Cosmos decide which memories to use?](https://help.clatterlabs.com/telegram/memory/how-memories-are-chosen): For each message, Cosmos looks up the memories most relevant to what you wrote, plus a few recent ones, and adds them to its context. - [How many things can Cosmos remember?](https://help.clatterlabs.com/telegram/memory/memory-limit): Up to 500 memories per account. When full, the oldest memory is dropped to make room. Each memory is a short sentence. - [Is /forget really permanent? Can I get my memories back?](https://help.clatterlabs.com/telegram/memory/forget-is-permanent): Yes, it's permanent. /forget erases the memories from active systems immediately. Backups are overwritten on a rolling cycle of up to 90 days. - [What does Cosmos remember about me?](https://help.clatterlabs.com/telegram/memory/what-is-memory): Cosmos saves short facts you share, like your name, job, projects, preferences and goals, and uses them in later chats. /memory shows them. - [Will Cosmos remember my password if I ask it to?](https://help.clatterlabs.com/telegram/memory/passwords-not-saved): No. Cosmos doesn't store passwords, keys, card numbers or ID numbers in memory, even if you ask. Use a password manager. ### Name, personality and language - [Can Cosmos be funny or sarcastic with me?](https://help.clatterlabs.com/telegram/name-persona-and-language/make-it-funny): Yes. Joke with it and it jokes back; tease it and it gets sassy. It stays kind and never makes up facts for a laugh. - [Can Cosmos talk in Egyptian Arabic?](https://help.clatterlabs.com/telegram/name-persona-and-language/egyptian-arabic): Yes. When you write in Egyptian Arabic, Cosmos answers in natural Egyptian colloquial Arabic, not formal Modern Standard Arabic. - [How do I get shorter or longer answers from Cosmos?](https://help.clatterlabs.com/telegram/name-persona-and-language/answer-length): Ask for it in your message ("in one sentence", "in detail"), or save it as a preference: "Remember I like short answers." - [How do I give Cosmos a different name?](https://help.clatterlabs.com/telegram/name-persona-and-language/rename-cosmos): Send /name followed by the new name, for example /name Zizo, or ask "call yourself Zizo". /name reset goes back to Cosmos. - [How do I make Cosmos less jokey?](https://help.clatterlabs.com/telegram/name-persona-and-language/make-it-serious): Tell it: "Be serious and brief, no jokes." It follows your style, and you can ask it to remember that preference. - [How does Cosmos decide how to talk to me?](https://help.clatterlabs.com/telegram/name-persona-and-language/personality): Cosmos mirrors your style: precise when you're to the point, playful when you joke, cheeky but kind when you tease. It's always honest. - [If I rename Cosmos, will it pretend to be a person?](https://help.clatterlabs.com/telegram/name-persona-and-language/rename-not-human): No. A custom name only changes what Cosmos calls itself. It stays honest that it's an AI by Clatter Labs. - [What happens to Cosmos's name if I sign out?](https://help.clatterlabs.com/telegram/name-persona-and-language/name-reset-cosmos): The custom name belongs to your Clatter Labs account and stays after /logout. Use /name reset to go back to Cosmos. - [Which languages does Cosmos on Telegram speak?](https://help.clatterlabs.com/telegram/name-persona-and-language/languages): Cosmos replies in the language and dialect you write in: English, Arabic (including Egyptian Arabic), and many other languages. - [Why does Cosmos use (or not use) emojis?](https://help.clatterlabs.com/telegram/name-persona-and-language/emojis): Cosmos mirrors you: it uses emojis about as much as you do. Ask it to stop or to use more, and it can remember the preference. ### Limits and usage - [Cosmos says I've reached my plan's usage limit](https://help.clatterlabs.com/telegram/limits-and-usage/plan-limit-telegram): Your Clatter Labs plan's window, weekly or monthly limit is used up across Line CLI, Cosmos Agent and Telegram. Wait for the reset or upgrade. - [Cosmos says I've used today's limit](https://help.clatterlabs.com/telegram/limits-and-usage/limit-reached): You've reached the 5,000,000-token daily limit. It resets at 00:00 UTC; /usage shows how long. Your plan limit can also stop requests. - [Does a paid plan give me more Cosmos on Telegram usage?](https://help.clatterlabs.com/telegram/limits-and-usage/does-upgrading-help): A paid plan raises your shared plan limits, but the Telegram bot keeps its own daily limit of 5,000,000 tokens per account. - [Does using Line CLI reduce what I can do on Telegram?](https://help.clatterlabs.com/telegram/limits-and-usage/usage-shared-with-line): Yes, for your plan: Line CLI, Cosmos Agent and Telegram share one plan limit. The Telegram daily limit counts only Telegram use. - [How do I check my usage in Cosmos on Telegram?](https://help.clatterlabs.com/telegram/limits-and-usage/usage-command): Send /usage. You see today's tokens against the 5,000,000 daily limit, model calls, time to reset, and your plan's % used and reset. - [How many messages can I send a day?](https://help.clatterlabs.com/telegram/limits-and-usage/how-many-messages): There's no fixed message count. The daily limit is 5,000,000 tokens, and how many messages that covers depends on what each one involves. - [I'm on a team. Do team limits apply to Cosmos on Telegram?](https://help.clatterlabs.com/telegram/limits-and-usage/limits-for-team-members): Yes. Team members use the owner's plan; the owner's access settings (Cosmos Agent, Telegram included) and member quotas apply in the bot too. - [What is a token?](https://help.clatterlabs.com/telegram/limits-and-usage/what-is-a-token): A token is a small piece of text, often part of a word, that AI models read and write. Usage and limits are measured in tokens. - [What is the daily limit in Cosmos on Telegram?](https://help.clatterlabs.com/telegram/limits-and-usage/daily-limit): Each Clatter Labs account can use up to 5,000,000 tokens a day in the Telegram bot. It resets at 00:00 UTC. Your plan's limits also apply. - [What uses up my tokens in Cosmos on Telegram?](https://help.clatterlabs.com/telegram/limits-and-usage/what-uses-tokens): Your message, recent conversation, memories, tool results like web pages and files, and Cosmos's reply all use tokens. Images and browser time too. - [When do Cosmos on Telegram limits reset?](https://help.clatterlabs.com/telegram/limits-and-usage/limits-reset-time): The Telegram daily limit resets at 00:00 UTC. Free plan usage resets on the 1st (UTC); paid plans reset per usage window and weekly. - [Where do I see Cosmos on Telegram usage in the Console?](https://help.clatterlabs.com/telegram/limits-and-usage/usage-in-console): Open console.clatterlabs.com › Billing for plan usage (% and reset). Telegram usage appears as "Cosmos Agent (Telegram)". - [Why do screenshots and recordings use so much of my limit?](https://help.clatterlabs.com/telegram/limits-and-usage/screenshots-use-more): Website screenshots and recordings use browser time, which counts toward your daily limit along with the tokens for the reply. - [Will I ever be charged for using Cosmos on Telegram?](https://help.clatterlabs.com/telegram/limits-and-usage/is-telegram-charged): No. Telegram usage is covered by your plan, Free included, and is never charged to your credits or card beyond your plan's price. ### Safety and the abuse policy - [How do I report a harmful or wrong answer from Cosmos?](https://help.clatterlabs.com/telegram/safety-and-abuse/report-harmful-answer): Email support@clatterlabs.com with a description, the time and your Account ID. A screenshot of the chat helps. - [How do I stay safe using Cosmos on Telegram?](https://help.clatterlabs.com/telegram/safety-and-abuse/stay-safe): Don't share passwords or card numbers, use only sign-in links from the bot, check important facts, and be careful sharing files publicly. - [How does the abuse policy work on Cosmos on Telegram?](https://help.clatterlabs.com/telegram/safety-and-abuse/abuse-policy-telegram): Insulting or cursing at the assistant earns a warning; a second time within 30 days pauses your account for 24 hours on every product. - [I lost my phone. How do I protect my Cosmos account?](https://help.clatterlabs.com/telegram/safety-and-abuse/lost-phone): Disconnect Cosmos Agent (Telegram) in your account's Connected apps, secure your Telegram account, and change your Clatter Labs password. - [Why can't Cosmos open my local or private web address?](https://help.clatterlabs.com/telegram/safety-and-abuse/private-addresses-blocked): For security, Cosmos only reads and screenshots public internet addresses. Local and private network addresses are blocked. - [Will Cosmos help with anything I ask?](https://help.clatterlabs.com/telegram/safety-and-abuse/harmful-requests): Cosmos helps with a wide range of tasks but follows Clatter Labs' Terms of Service and acceptable use rules, and may decline harmful requests. ### Privacy and your data - [Are my chats with Cosmos encrypted?](https://help.clatterlabs.com/telegram/privacy-and-data/is-chat-encrypted): Messages travel between Telegram and Clatter Labs over encrypted connections, and data is encrypted at rest. Bot chats aren't Telegram secret chats. - [Can Clatter Labs see my phone number through the bot?](https://help.clatterlabs.com/telegram/privacy-and-data/phone-number): The bot receives your Telegram user id, username, display name and chat id, and what you send. Telegram doesn't give bots your phone number. - [Does Clatter Labs use my Telegram chats to train AI?](https://help.clatterlabs.com/telegram/privacy-and-data/training): Clatter Labs may use pseudonymized content, with secrets filtered, to train its own models. You can object with a privacy request. - [Does Cosmos know where I am?](https://help.clatterlabs.com/telegram/privacy-and-data/location): No. Cosmos doesn't get your location from Telegram. It only knows a place or time zone if you tell it, and it can remember that. - [How do I delete all my Cosmos on Telegram data?](https://help.clatterlabs.com/telegram/privacy-and-data/delete-my-data): Use /forget for memories, /logout to remove chat history and the link, delete files in Code Buckets, or delete your account for everything. - [How do I download my Cosmos on Telegram data?](https://help.clatterlabs.com/telegram/privacy-and-data/export-my-data): Download your Clatter Labs account data export from your account settings. It includes Telegram data such as memories, settings and reminders. - [How long does Cosmos keep my chat history?](https://help.clatterlabs.com/telegram/privacy-and-data/history-retention): Cosmos keeps a limited recent history per conversation, trimmed over time. /logout deletes it; account deletion removes everything. - [If I delete messages in Telegram, are they deleted from Clatter Labs too?](https://help.clatterlabs.com/telegram/privacy-and-data/deleting-telegram-messages): Deleting messages in the Telegram app doesn't remove the copies Cosmos stored. Use /new, /logout, /forget or account deletion instead. - [What data does Cosmos on Telegram store about me?](https://help.clatterlabs.com/telegram/privacy-and-data/what-data-is-stored): Your Telegram ids and names, recent messages, memories, reminders, settings (name, time zone), usage, and files in your Code Buckets. - [What happens to my data if Cosmos on Telegram is discontinued?](https://help.clatterlabs.com/telegram/privacy-and-data/if-service-ends): If a Clatter Labs service ends, the Privacy Policy says you'll get notice where practicable and a chance to export, then the data is deleted. - [What happens to my Telegram data if I delete my Clatter Labs account?](https://help.clatterlabs.com/telegram/privacy-and-data/after-account-deletion): Deleting your account deletes Telegram data linked to it, unlinks the bot and revokes access. Deletion starts promptly. - [Who can open the files Cosmos stores for me?](https://help.clatterlabs.com/telegram/privacy-and-data/files-privacy): Documents stay private in your Code Buckets until you share them. Images get an unguessable public link anyone with the link can open. - [Who can see my chats with Cosmos?](https://help.clatterlabs.com/telegram/privacy-and-data/who-can-see-my-chats): Your chats are processed by Clatter Labs to answer you. People review content only for support you ask for, security, abuse or the law. ### Troubleshooting - [/forget says some memories are still there](https://help.clatterlabs.com/telegram/troubleshooting/forget-failed): If /forget couldn't delete everything, it tells you how many remain. Run /forget again; if it keeps failing, contact support. - [Cosmos answers in the wrong language](https://help.clatterlabs.com/telegram/troubleshooting/answers-in-wrong-language): Cosmos replies in the language you write in. Tell it which language you want, and ask it to remember that preference. - [Cosmos gets the time wrong](https://help.clatterlabs.com/telegram/troubleshooting/wrong-time-replies): Cosmos uses Africa/Cairo until you set your time zone. Send /timezone to check, then set yours with /timezone Region/City. - [Cosmos is stuck on "Thinking…"](https://help.clatterlabs.com/telegram/troubleshooting/stuck-on-thinking-telegram): Big requests with many tools take time. Tap Stop or send /stop, then resend a simpler request. Check /usage and the status page. - [Cosmos on Telegram isn't replying](https://help.clatterlabs.com/telegram/troubleshooting/bot-not-responding): Check you pressed Start and are in a private chat, look for a sign-in button, check limits with /usage, and see the status page. - [Cosmos said it set a reminder or saved a file, but nothing happened](https://help.clatterlabs.com/telegram/troubleshooting/cosmos-says-done-but-nothing): Cosmos is built to only claim actions its tools really did. Check /reminders, /memory or /files, and ask it to try again if missing. - [Cosmos says "I couldn't save that file"](https://help.clatterlabs.com/telegram/troubleshooting/cant-save-file): Saving to your Code Buckets failed. Try again in a moment; check your Code Buckets storage isn't full and the file is under 20 MB. - [Cosmos says it couldn't find the place for the weather](https://help.clatterlabs.com/telegram/troubleshooting/weather-place-not-found): Use a clear city name, add the country, or check the spelling. The weather lookup needs a recognizable place name. - [How do I contact a human about Cosmos on Telegram?](https://help.clatterlabs.com/telegram/troubleshooting/contact-support-telegram): Email support@clatterlabs.com or team@clatterlabs.xyz, or use the Support Center. For data deletion, email infrastructure@clatterlabs.xyz. - [I blocked or stopped the bot by mistake. What now?](https://help.clatterlabs.com/telegram/troubleshooting/blocked-the-bot): Unblock @Cosmos_agents_bot in Telegram and press Start. You're still linked unless you used /logout; reminders sent while blocked failed. - [I don't see the Sign in with Clatter Labs button](https://help.clatterlabs.com/telegram/troubleshooting/sign-in-button-missing): Send /start. If you're within 15 hours of your last link, the bot tells you how long to wait instead of sending a button. - [Tapping a button says "Not signed in. Send /start."](https://help.clatterlabs.com/telegram/troubleshooting/not-signed-in-button): Buttons only work while your Telegram is linked. You were signed out; send /start to sign in again, then repeat the action. - [Tapping Allow says "This request expired"](https://help.clatterlabs.com/telegram/troubleshooting/button-request-expired): Allow/Deny requests for sharing or deleting files expire after 30 minutes. Ask Cosmos again and tap the new button. - [The sign-in page says "Already linked"](https://help.clatterlabs.com/telegram/troubleshooting/already-linked-page): Your Telegram account is already signed in. Go back to the bot and keep chatting; there's nothing more to do. - [The snooze button says "Couldn't snooze it"](https://help.clatterlabs.com/telegram/troubleshooting/snooze-failed): Snoozing fails if the reminder no longer exists or you've hit 50 pending reminders. Cancel some reminders or set a new one manually. ## Code Buckets Projects, buckets, uploads, public and private files, the CDN, the API, limits and backups. ### Getting started - [Can Code Buckets sync a folder on my computer automatically?](https://help.clatterlabs.com/code-buckets/getting-started/sync-folder-to-bucket): There's no sync app. Zip the folder and upload it, or script uploads with the API from your machine or CI. - [Can I mount a bucket as a drive on my computer?](https://help.clatterlabs.com/code-buckets/getting-started/mount-bucket-as-drive): No. Use the Console to browse and upload, or the API to script transfers. - [Can I store datasets, videos or Docker image exports?](https://help.clatterlabs.com/code-buckets/getting-started/datasets-and-docker-images): Yes, as assets, up to 10 GB per bucket and within your plan's storage. Large files upload and download in 16 MiB chunks. - [Can I use Code Buckets to keep my school coding projects safe?](https://help.clatterlabs.com/code-buckets/getting-started/code-buckets-for-kids-and-school): Yes. Zip your project, upload it to a bucket and take a backup. Keep it private unless your teacher needs a link. - [Do I need a Clatter Labs account to use Code Buckets?](https://help.clatterlabs.com/code-buckets/getting-started/do-i-need-an-account): Yes. Sign in to the Console with your Clatter Labs account, the same one you use for every Clatter Labs product. - [How are accounts, projects, buckets and files organized?](https://help.clatterlabs.com/code-buckets/getting-started/how-code-buckets-is-organized): Account (CL-) holds projects (cbp_), projects hold buckets (cbk_), and buckets hold objects (cbo_), a code tree, events (cbe_) and backups (cbb_). - [How do I get started with Code Buckets?](https://help.clatterlabs.com/code-buckets/getting-started/code-buckets-quickstart): Create a project and a bucket, upload a zip and browse the code, in the Console or with the API, in about five minutes. - [How do I know if Code Buckets is working normally?](https://help.clatterlabs.com/code-buckets/getting-started/code-buckets-status): Check status.clatterlabs.com for live health and incidents. Repeated 502 or 503 errors are a sign to look there. - [How is Code Buckets different from a Git repository?](https://help.clatterlabs.com/code-buckets/getting-started/code-buckets-vs-git-hosting): Code Buckets stores zips and assets by project with preview, events and backups, without branches, commits or comment threads to manage. - [I'm new to coding. How do I put my first project in Code Buckets?](https://help.clatterlabs.com/code-buckets/getting-started/first-five-minutes-kids): A step-by-step guide for total beginners: zip a folder, make a project and bucket in the Console, and drag the zip in. - [Is Code Buckets compatible with S3 tools?](https://help.clatterlabs.com/code-buckets/getting-started/is-code-buckets-s3-compatible): No. It has its own small HTTPS API with chunked uploads. Use the docs' uploader or write a short script. - [Is Code Buckets free?](https://help.clatterlabs.com/code-buckets/getting-started/is-code-buckets-free): Every plan includes Code Buckets: 1,000,000 tokens a month and 1 backup, with 1 GB of storage on Free and more on paid plans. - [Is Code Buckets like a cloud drive for my files?](https://help.clatterlabs.com/code-buckets/getting-started/is-code-buckets-like-google-drive): A bit, but it's built for code: zips become browsable code trees, every change is recorded, and there's an API for automation. - [Should I use the Console or the API for Code Buckets?](https://help.clatterlabs.com/code-buckets/getting-started/code-buckets-console-or-api): Use the Console to manage buckets by hand; use the API to automate uploads, backups and downloads from builds, scripts and agents. - [What do the Code Buckets terms mean?](https://help.clatterlabs.com/code-buckets/getting-started/code-buckets-glossary): A short glossary: project, bucket, object, archive, asset, code tree, ref, event, backup, token, visibility and public URL. - [What is Code Buckets?](https://help.clatterlabs.com/code-buckets/getting-started/what-is-code-buckets): Code Buckets is Clatter Labs' encrypted storage for code and assets, organized into projects and buckets, with code preview, events and backups. - [What kinds of files can I store in Code Buckets?](https://help.clatterlabs.com/code-buckets/getting-started/what-can-i-store): Zips of code (unpacked for preview) and any other file as an asset: images, builds, datasets, videos and more, up to 10 GB per bucket. - [What's the difference between MB and MiB in Code Buckets?](https://help.clatterlabs.com/code-buckets/getting-started/what-is-mib): A MiB is 1,048,576 bytes (2^20); a MB is often 1,000,000. Code Buckets chunks and tokens use MiB. - [Who is Code Buckets for?](https://help.clatterlabs.com/code-buckets/getting-started/who-is-code-buckets-for): Developers, teams, agencies, students and automated tools that need safe, organized storage for code and assets. - [Why does Code Buckets want my code as a zip?](https://help.clatterlabs.com/code-buckets/getting-started/uploads-are-zips): A zip carries a whole folder in one file. Code Buckets stores it encrypted and unpacks it into a browsable code tree. ### Projects - [Can I move a bucket to another project?](https://help.clatterlabs.com/code-buckets/projects/move-bucket-between-projects): There's no move endpoint. Create a bucket in the other project, copy the files over, then delete the old bucket. - [Can I transfer a project to another Clatter Labs account?](https://help.clatterlabs.com/code-buckets/projects/transfer-project-to-another-account): There's no transfer feature. The other account can create its own project and upload copies of the files. - [How do agencies organize client work in Code Buckets?](https://help.clatterlabs.com/code-buckets/projects/project-for-each-client): Use one project per client, a bucket per deliverable, a public bucket for shareable assets, and clear names and descriptions. - [How do I create a project with the API?](https://help.clatterlabs.com/code-buckets/projects/create-a-project): Create a project in the Console with a name, or with POST /v1/projects. You get a Project ID (cbp_) back. - [How do I delete a project with the API?](https://help.clatterlabs.com/code-buckets/projects/delete-a-project): A project can be deleted once it has no buckets. Delete its buckets first, then the project, in the Console or with the API. - [How do I find a project's ID if I only know its name?](https://help.clatterlabs.com/code-buckets/projects/find-a-project-by-name): List projects with GET /v1/projects and match on name, or open the project in the Console and copy its ID. - [How do I rename a project or change its description?](https://help.clatterlabs.com/code-buckets/projects/rename-a-project): Use PATCH /v1/projects/{project_id} with a new name or description. The Project ID stays the same. - [How do I see everything that happened in a project?](https://help.clatterlabs.com/code-buckets/projects/project-events): GET /v1/projects/{project_id}/events returns project changes plus every event in its buckets, newest first. The Console shows the same feed. - [How many buckets can a project hold?](https://help.clatterlabs.com/code-buckets/projects/project-limit-100-buckets): Up to 100 buckets per project. Creating more answers 409 limit_reached. - [How should I organize my projects and buckets?](https://help.clatterlabs.com/code-buckets/projects/how-to-structure-projects): A project per app, client or product; a bucket per part, environment or kind of content. Here are patterns that work. - [I get 409 limit_reached when creating a project. What now?](https://help.clatterlabs.com/code-buckets/projects/too-many-projects): An account can have up to 100 projects. Delete projects you no longer need, or group more buckets into existing projects. - [I get 409 project_not_empty when deleting a project. Why?](https://help.clatterlabs.com/code-buckets/projects/project-not-empty): Projects can only be deleted when they have no buckets. Delete the project's buckets first, then try again. - [What are the rules for project names and descriptions?](https://help.clatterlabs.com/code-buckets/projects/project-name-rules): Project names are up to 80 characters and descriptions up to 500. The Project ID, not the name, identifies the project. - [What is a project in Code Buckets?](https://help.clatterlabs.com/code-buckets/projects/what-is-a-project): A project groups related buckets, like an app, a client or a monorepo. Each has a permanent Project ID starting with cbp_. - [Where do I find my Project ID?](https://help.clatterlabs.com/code-buckets/projects/find-project-id): The Console shows the Project ID with a copy button on the project page. The API returns it as id when you create or list projects. ### Buckets - [Creating a bucket failed with 503 storage_unavailable. What now?](https://help.clatterlabs.com/code-buckets/buckets/bucket-create-slow-or-503): Storage for the new bucket couldn't be set up at that moment. Wait a little and try again. - [How do I create a bucket with the API?](https://help.clatterlabs.com/code-buckets/buckets/create-a-bucket): Create a bucket inside a project in the Console, or with POST /v1/projects/{project_id}/buckets. You get a bucket id (cbk_) back. - [How do I delete a bucket with the API?](https://help.clatterlabs.com/code-buckets/buckets/delete-a-bucket): Delete a bucket from the Console or with DELETE /v1/buckets/{bucket_id}. It disappears and stops counting toward your usage. - [How do I list the buckets in a project?](https://help.clatterlabs.com/code-buckets/buckets/list-buckets-in-project): GET /v1/projects/{project_id}/buckets returns the project's buckets, newest first, with their storage use. - [How do I make a bucket read-only for an app or person?](https://help.clatterlabs.com/code-buckets/buckets/read-only-bucket): There's no read-only switch. Give that app a key with only buckets:read, so it can read and download but not change anything. - [How do I rename a bucket or change its settings?](https://help.clatterlabs.com/code-buckets/buckets/rename-a-bucket): PATCH /v1/buckets/{bucket_id} changes name, description, preview or visibility. Only the fields you send change. - [How do I see how much space a bucket is using?](https://help.clatterlabs.com/code-buckets/buckets/check-bucket-space): GET /v1/buckets/{bucket_id} returns storage.used_bytes, pending_bytes and limit_bytes. The Console shows usage too. - [How do I set up a bucket for website images?](https://help.clatterlabs.com/code-buckets/buckets/bucket-for-website-images): Make a public bucket for images, upload them with the right content type, and use the img.cdn.clatterlabs.xyz links in your site. - [How do I turn off preview for a bucket with the API?](https://help.clatterlabs.com/code-buckets/buckets/turn-off-preview): Send PATCH /v1/buckets/{bucket_id} with "preview": false, or change it in the bucket's settings in the Console. - [How many buckets can I have?](https://help.clatterlabs.com/code-buckets/buckets/how-many-buckets): Up to 100 buckets per project and 100 projects per account. Total storage is set by your plan. - [How many files can a bucket hold?](https://help.clatterlabs.com/code-buckets/buckets/file-count-per-bucket): The docs limit storage (10 GB per bucket), not object count. Preview has its own limits: about 20,000 files per zip. - [How much can one bucket hold?](https://help.clatterlabs.com/code-buckets/buckets/bucket-size-limit): Up to 10 GB (10,737,418,240 bytes) per bucket, counting stored zips and assets plus unfinished uploads, on every plan. - [I deleted a bucket by mistake. Can I get it back?](https://help.clatterlabs.com/code-buckets/buckets/deleted-bucket-recovery): There's no published undelete for buckets. Contact support straight away with your Account ID and the bucket id. - [I get 413 bucket_full. What can I do?](https://help.clatterlabs.com/code-buckets/buckets/bucket-full-413): The upload would take the bucket past 10 GB, counting unfinished uploads. Abort stale uploads, delete objects or use another bucket. - [Should my bucket be public or private?](https://help.clatterlabs.com/code-buckets/buckets/bucket-public-or-private-choose): Keep code buckets private. Use a separate public bucket for files meant for anyone, like website images and downloads. - [What are the rules for bucket names?](https://help.clatterlabs.com/code-buckets/buckets/bucket-names): Bucket names are up to 80 characters and descriptions up to 500. The bucket id (cbk_) identifies the bucket. - [What do the fields on a bucket mean?](https://help.clatterlabs.com/code-buckets/buckets/bucket-fields-explained): A bucket returns its id, project, name, preview, visibility, code (ref, files, bytes), storage (used, pending, limit) and encryption. - [What does the encryption field on a bucket tell me?](https://help.clatterlabs.com/code-buckets/buckets/bucket-encryption-field): It describes how the bucket's stored files are encrypted: AES-256-GCM with the bucket's own key, wrapped by a Clatter Labs master key. - [What is a bucket?](https://help.clatterlabs.com/code-buckets/buckets/what-is-a-bucket): A bucket lives in one project and holds up to 10 GB of code and assets, with its own encryption key, code tree, events and backups. - [What's the difference between the 10 GB bucket limit and my plan's storage?](https://help.clatterlabs.com/code-buckets/buckets/bucket-storage-vs-plan-storage): Each bucket holds up to 10 GB. Your plan sets the total across all buckets, from 1 GB on Free to 1 TB on Ultra. - [Why is code.ref null on my bucket?](https://help.clatterlabs.com/code-buckets/buckets/empty-bucket-ref-null): ref stays null until the first zip is unpacked. Buckets with only assets, or with preview off, have no code tree. - [Why is my bucket's used space bigger than my zip?](https://help.clatterlabs.com/code-buckets/buckets/used-bytes-vs-zip-size): used_bytes counts every stored zip and asset in the bucket, not just the latest, plus pending_bytes for unfinished uploads. ### Uploading files - [Can Code Buckets fetch a file from a URL for me?](https://help.clatterlabs.com/code-buckets/uploads/import-from-url): No. There's no import-from-URL endpoint. Download the file yourself and upload it, or script both steps. - [Can file names contain spaces, emoji or non-English letters?](https://help.clatterlabs.com/code-buckets/uploads/unicode-file-names): File names can be up to 255 characters with no slashes. URL-encode them in links and file paths. - [Can I make a file public as I upload it?](https://help.clatterlabs.com/code-buckets/uploads/upload-visibility-at-start): Yes. Pass "visibility": "public" and the right content_type when starting the upload. public_url works once it completes. - [Can I resume an upload after aborting it?](https://help.clatterlabs.com/code-buckets/uploads/aborted-upload-resume): No. An aborted upload is closed and its chunks are discarded. Start a new upload. - [Can I upload a .tar.gz or .rar file?](https://help.clatterlabs.com/code-buckets/uploads/upload-tar-gz): Yes, as an asset. Only .zip files are unpacked into the code tree for preview. - [Can I upload a folder without zipping it?](https://help.clatterlabs.com/code-buckets/uploads/upload-folder-not-zip): Uploads are files. Zip the folder so it unpacks into the code tree, or upload each file separately as an asset. - [Can I upload a password-protected zip?](https://help.clatterlabs.com/code-buckets/uploads/password-protected-zips): Yes, it's stored encrypted like any file, but its protected entries can't be previewed in the code tree. - [Can I upload an empty file?](https://help.clatterlabs.com/code-buckets/uploads/upload-empty-file): The docs don't describe zero-byte uploads. If you need a placeholder, upload a small file instead. - [Can I upload chunks in parallel?](https://help.clatterlabs.com/code-buckets/uploads/parallel-chunk-uploads): Yes. Chunks can go in any order and at the same time. Three or four at once is a good default. - [Can I upload the same zip to two buckets?](https://help.clatterlabs.com/code-buckets/uploads/same-zip-two-buckets): Yes. Each upload is a separate object in its own bucket, counted separately for storage and tokens. - [How big is each chunk, and how many chunks can a file have?](https://help.clatterlabs.com/code-buckets/uploads/chunk-size-and-count): Chunks are 16 MiB (16,777,216 bytes), except the last. A file can have up to 1,000 chunks. - [How can I make uploads faster?](https://help.clatterlabs.com/code-buckets/uploads/upload-speed-tips): Send 3–4 chunks in parallel, use the one-request upload for small files, and retry failed chunks instead of restarting. - [How do I cancel an upload I won't finish?](https://help.clatterlabs.com/code-buckets/uploads/abort-an-upload): POST /v1/uploads/{upload_id}/abort cancels an unfinished upload and frees the space it reserved. - [How do I find unfinished uploads taking up space?](https://help.clatterlabs.com/code-buckets/uploads/find-unfinished-uploads): List objects in the bucket; unfinished uploads appear with status uploading. Abort the ones you don't need. - [How do I make sure my upload wasn't corrupted?](https://help.clatterlabs.com/code-buckets/uploads/checksums-on-upload): Send X-Content-SHA256 with each chunk. If the bytes changed on the way, the API refuses the chunk with 400 checksum_mismatch. - [How do I resume an interrupted upload with the API?](https://help.clatterlabs.com/code-buckets/uploads/resume-an-upload): GET /v1/uploads/{upload_id} lists received_chunks. Send only the missing chunks, then complete. Nothing already sent is lost. - [How do I show upload progress in my own tool?](https://help.clatterlabs.com/code-buckets/uploads/upload-progress): Count completed chunks out of chunk_count, or check received_chunks with GET /v1/uploads/{upload_id}. - [How do I update just one folder of my code without replacing everything?](https://help.clatterlabs.com/code-buckets/uploads/upload-into-a-folder): Upload a zip with target_path (like packages/api). Only that folder of the code tree is replaced; the rest stays. - [How do I upload a small file (up to 4 MiB) in one request?](https://help.clatterlabs.com/code-buckets/uploads/upload-small-file-one-request): POST the file's bytes to /v1/buckets/{bucket_id}/objects?name=… to store it in one call instead of start, chunk and complete. - [How do I upload a zip with the API?](https://help.clatterlabs.com/code-buckets/uploads/upload-a-zip-with-the-api): Start the upload with name and size, PUT each 16 MiB chunk, then complete. Here's a cURL example. - [How do I upload build artefacts from CI?](https://help.clatterlabs.com/code-buckets/uploads/upload-from-ci): Use a key with buckets:write stored as a CI secret, then run the start, chunk and complete flow (or the one-request upload for small files). - [How do uploads work in Code Buckets?](https://help.clatterlabs.com/code-buckets/uploads/how-uploads-work): Every upload is start, send 16 MiB chunks, complete. Chunks can go in parallel, be retried safely and resume after a drop. - [How long does it take before my uploaded code shows up?](https://help.clatterlabs.com/code-buckets/uploads/zip-preview-processing-time): Usually a few seconds after completing; longer for very large zips. Watch for the code.updated event or poll the upload. - [How many tokens does an upload use?](https://help.clatterlabs.com/code-buckets/uploads/upload-tokens-cost): 1 token per request plus 1 per MiB of data. A 100 MiB zip uses about 109 tokens including start and complete. - [I get 400 bad_chunk or bad_chunk_size. What's wrong?](https://help.clatterlabs.com/code-buckets/uploads/bad-chunk-size): The index is outside 0 to chunk_count - 1, or the chunk isn't exactly chunk_size bytes (only the last chunk may be shorter). - [I get 409 upload_closed. What does it mean?](https://help.clatterlabs.com/code-buckets/uploads/upload-closed-409): The upload is already complete or aborted, so it can't take more chunks or be aborted again. - [I get 409 upload_incomplete when completing. What do I do?](https://help.clatterlabs.com/code-buckets/uploads/upload-incomplete-409): Some chunks are missing. error.missing_chunks lists up to 50; send them, then complete again. - [I lost the upload id for an unfinished upload. How do I find it?](https://help.clatterlabs.com/code-buckets/uploads/lost-upload-id): List the bucket's objects; unfinished uploads show with status uploading, and their id is the upload id. - [What can I send when starting an upload?](https://help.clatterlabs.com/code-buckets/uploads/start-upload-fields): name and size are required; kind, target_path, content_type and visibility are optional. Here's what each does. - [What do the upload statuses uploading, processing, ready and failed mean?](https://help.clatterlabs.com/code-buckets/uploads/upload-statuses): uploading while chunks arrive, processing while a zip's tree is built, ready when stored, failed if something went wrong. - [What happens if I send the same chunk twice?](https://help.clatterlabs.com/code-buckets/uploads/duplicate-chunk): It's safe. The same bytes answer "duplicate": true; different bytes replace the earlier chunk. - [What happens if I upload a file with the same name twice?](https://help.clatterlabs.com/code-buckets/uploads/upload-same-name-twice): Each upload becomes its own object with its own id. The earlier file isn't overwritten; delete it if you don't need it. - [What happens if two uploads to the same bucket happen at once?](https://help.clatterlabs.com/code-buckets/uploads/two-people-upload-same-bucket): Each upload is independent. For zips, each one that finishes builds a new code tree version; check code.updated events to see the order. - [What happens when I complete an upload?](https://help.clatterlabs.com/code-buckets/uploads/complete-an-upload): The API checks every chunk arrived and stores the file. Assets are ready right away; zips are processed into the code tree, then ready. - [What's the largest file I can upload?](https://help.clatterlabs.com/code-buckets/uploads/upload-largest-file): A file can have up to 1,000 chunks of 16 MiB, and it must fit in the bucket's 10 GB and your plan's storage. - [When is a file stored as an archive and when as an asset?](https://help.clatterlabs.com/code-buckets/uploads/zip-or-asset): .zip names default to archive (unpacked for preview); everything else is an asset. Set kind to asset to keep a zip as a plain file. - [Why did my upload delete the other files in my code view?](https://help.clatterlabs.com/code-buckets/uploads/zip-replaces-whole-tree): A zip replaces the whole code tree unless you upload it with target_path. Older trees stay reachable by their ref. - [Why must I know the exact file size before starting an upload?](https://help.clatterlabs.com/code-buckets/uploads/upload-exact-size-required): The size sets the chunk layout and reserves space in the bucket. A wrong size causes bad_chunk_size or missing chunks. - [Why should I set content_type when uploading?](https://help.clatterlabs.com/code-buckets/uploads/content-type-on-upload): content_type decides the Content-Type on download and on public links, and whether a file is served as an image. ### Downloading files - [How do I check a downloaded file is exactly what I uploaded?](https://help.clatterlabs.com/code-buckets/downloads/verify-downloaded-file): Downloads are decrypted and verified on our side. For your own check, compare SHA-256 hashes, per chunk or for the whole file. - [How do I copy a file from one bucket to another?](https://help.clatterlabs.com/code-buckets/downloads/copy-file-between-buckets): Download it from the first bucket and upload it to the second. There's no server-side copy. - [How do I download a file from a bucket?](https://help.clatterlabs.com/code-buckets/downloads/download-a-file): GET /v1/buckets/{bucket_id}/objects/{object_id}/content streams the original file, decrypted, for files up to 1 GB. - [How do I download a file from the Console?](https://help.clatterlabs.com/code-buckets/downloads/download-from-console): Open the bucket's files in the Console and download the one you need. Downloaded data counts 1 token per MiB. - [How do I download a file larger than 1 GB?](https://help.clatterlabs.com/code-buckets/downloads/download-large-file-in-chunks): Download chunks 0 to chunk_count - 1 with GET …/chunks/{index} and join them in order. Each chunk carries its SHA-256. - [How do I download an older version of my code?](https://help.clatterlabs.com/code-buckets/downloads/download-old-code-version): Download the zip object you uploaded at the time, or read the old tree by ref. Both stay available unless deleted. - [How do I download everything in a bucket?](https://help.clatterlabs.com/code-buckets/downloads/download-whole-bucket): List the bucket's objects and download each one. There's no single "download bucket" request. - [How do I download one file from my code without the whole zip?](https://help.clatterlabs.com/code-buckets/downloads/download-code-file-from-tree): GET /v1/buckets/{bucket_id}/files/{path}?download=1 returns that file's raw bytes from the code tree. - [How many tokens do downloads use?](https://help.clatterlabs.com/code-buckets/downloads/download-cost-tokens): 1 token per request plus 1 per MiB downloaded. A 1 GB file costs about 1,025 tokens. - [I get 409 not_ready when downloading or reading an object. Why?](https://help.clatterlabs.com/code-buckets/downloads/download-not-ready-409): The upload hasn't been completed yet. Finish (complete) the upload, or wait for it, then try again. - [I get 413 use_chunks when downloading. What does it mean?](https://help.clatterlabs.com/code-buckets/downloads/use-chunks-413): The file is over 1 GB, so it can't be downloaded in one request. Download it chunk by chunk; error.chunk_count says how many. ### Public and private files - [Are my files private by default?](https://help.clatterlabs.com/code-buckets/public-files/private-by-default): Yes. Every bucket and file is private unless you choose otherwise. Private files can only be read with your key and Account ID or in the Console. - [Can I change the cache settings of my public files?](https://help.clatterlabs.com/code-buckets/public-files/custom-cache-headers): No. Images are cached for a year as immutable and other files for 60 seconds. Upload a new file to change content. - [Can I host a website from a public bucket?](https://help.clatterlabs.com/code-buckets/public-files/host-a-website-on-code-buckets): Not as a full website: HTML on the files host is served with a sandboxing CSP, so scripts can't run. It's great for images and downloads. - [Can I host web fonts in Code Buckets?](https://help.clatterlabs.com/code-buckets/public-files/host-web-fonts): Yes. Upload font files with their content type, make them public, and load them from your CSS. CORS allows any site. - [Can I make my code preview public?](https://help.clatterlabs.com/code-buckets/public-files/preview-tree-never-public): No. The code preview tree (files unpacked from zips) is never public. To publish a code file, upload it as an asset. - [Can I see how many times my public files were opened?](https://help.clatterlabs.com/code-buckets/public-files/count-downloads-of-public-file): GET /v1/usage shows this month's public link traffic: requests, bytes and tokens. Per-file counts aren't published. - [Can I serve my site's JavaScript and CSS files from Code Buckets?](https://help.clatterlabs.com/code-buckets/public-files/cdn-for-js-css): Yes, as public files on files.cdn-buckets with the right content type and CORS. They're cached 60 seconds; traffic counts as tokens. - [Can I share a private file with one person without making it public?](https://help.clatterlabs.com/code-buckets/public-files/share-private-file-temporarily): There's no per-person or expiring link. Make it public, share, then make it private again, or send them the file directly. - [Can I stream a video from a public link?](https://help.clatterlabs.com/code-buckets/public-files/stream-video-from-bucket): Yes. The files host supports Range requests (206), so videos stream and seek. Set content_type to the right video type when uploading. - [Can I use my own domain for public file links?](https://help.clatterlabs.com/code-buckets/public-files/custom-domain-for-public-links): The docs don't offer custom domains. Public links use img.cdn.clatterlabs.xyz and files.cdn-buckets.clatterlabs.xyz. - [Can other sites use my public images on their pages?](https://help.clatterlabs.com/code-buckets/public-files/hotlinking-public-images): Yes. Public links work for anyone and allow CORS, and their traffic counts toward your tokens. Make an image private to stop it. - [Can other websites load my public files with JavaScript?](https://help.clatterlabs.com/code-buckets/public-files/public-files-and-cors): Yes. Both public hosts send Access-Control-Allow-Origin: *, so any website can fetch public files. - [Can search engines find my public files?](https://help.clatterlabs.com/code-buckets/public-files/public-file-search-engines): Anyone with a link can open a public file, and links you publish on web pages can be found. Keep sensitive files private. - [Do public links expire?](https://help.clatterlabs.com/code-buckets/public-files/public-links-expire): No. A public link works while the file is public and stored. It stops when you make it private or delete it. - [Do views of my public links cost tokens?](https://help.clatterlabs.com/code-buckets/public-files/public-traffic-tokens): Yes. Public link traffic counts for your account like API downloads: 1 token per request plus 1 per MiB, shown in usage. - [How do bucket visibility and file visibility work together?](https://help.clatterlabs.com/code-buckets/public-files/bucket-visibility-vs-file-visibility): A file is public or private by its own setting, or follows the bucket when set to inherit. effective_visibility shows the result. - [How do I get a file's current public link from the API?](https://help.clatterlabs.com/code-buckets/public-files/get-public-url-endpoint): GET …/objects/{object_id}/public-url returns url, served_as, content_type and whether the link works right now. - [How do I list only my public files?](https://help.clatterlabs.com/code-buckets/public-files/list-public-files): List objects and filter on effective_visibility == public in your code. Each object also carries its public_url. - [How do I make a file public and get its link?](https://help.clatterlabs.com/code-buckets/public-files/make-a-file-public): Set the file's visibility to public in the Console or with PATCH …/objects/{object_id}/visibility. The response includes public_url. - [How do I make a public file private again?](https://help.clatterlabs.com/code-buckets/public-files/make-file-private-again): Set its visibility to private (or inherit in a private bucket). The link stops working on the next request. - [How do I make a public link download instead of opening in the browser?](https://help.clatterlabs.com/code-buckets/public-files/force-download-link): Add ?download=1 to a files.cdn-buckets link. On an old image link, ?download=1 gets the original from the files host. - [How do I make a whole bucket public with the API?](https://help.clatterlabs.com/code-buckets/public-files/make-whole-bucket-public): PATCH /v1/buckets/{bucket_id}/visibility with "public", or Settings › Access in the Console. Files on inherit follow it. - [How do I share a PDF with a public link?](https://help.clatterlabs.com/code-buckets/public-files/public-pdf): Upload the PDF with content_type application/pdf, make it public, and share its link. It opens in the browser; add ?download=1 to download. - [How do I share a release zip for people to download?](https://help.clatterlabs.com/code-buckets/public-files/public-zip-for-downloads): Upload the zip as an asset, make it public, and share its files.cdn-buckets link with ?download=1. - [How do I use Code Buckets images on my website or in emails?](https://help.clatterlabs.com/code-buckets/public-files/use-image-links-on-website): Make the image public, copy its img.cdn.clatterlabs.xyz link and put it in tags, Markdown, emails or Open Graph tags. - [How does Code Buckets decide a file is an image?](https://help.clatterlabs.com/code-buckets/public-files/what-counts-as-an-image): Its content_type is image/*, or, when that's empty or application/octet-stream, its extension is an image one like .png or .webp. - [How long do public links stay cached?](https://help.clatterlabs.com/code-buckets/public-files/public-link-caching): Images are cached for a year as immutable; other files for 60 seconds. Turning a file private blocks the link on the next request. - [I made an image public again and its old link still gives 404. Why?](https://help.clatterlabs.com/code-buckets/public-files/image-link-changed): When an image stops being public its id is retired for good. Making it public again gives it a new id and a new public_url. - [I replaced an image but people still see the old one. Why?](https://help.clatterlabs.com/code-buckets/public-files/update-a-public-image): Image links are immutable and cached for a year. Upload the new image as a new file and use its new link. - [My public link returns 404. What's wrong?](https://help.clatterlabs.com/code-buckets/public-files/public-link-404): The file is private (directly or through its bucket), was deleted, isn't finished uploading, or it's an image whose old id was retired. - [What does served_as mean on an object?](https://help.clatterlabs.com/code-buckets/public-files/served-as-field): served_as is image when the public link is on img.cdn.clatterlabs.xyz, or file when it's on files.cdn-buckets.clatterlabs.xyz. - [What does the files.cdn-buckets host support?](https://help.clatterlabs.com/code-buckets/public-files/files-host-features): Inline display, ?download=1, HEAD, single Range requests, ETag/If-None-Match, sandboxing CSP for HTML/SVG/XML, and 60-second caching. - [What happens to my public links if I run out of monthly tokens?](https://help.clatterlabs.com/code-buckets/public-files/public-quota-exceeded): When the month's tokens are used, requests answer 402 quota_exceeded until next month. Watch public_files usage and contact us for more. - [What happens to public links when I switch a public bucket to private?](https://help.clatterlabs.com/code-buckets/public-files/bucket-made-private-effect): Files set to inherit become private and their links stop on the next request. Files set to public explicitly stay public. - [Why do some public links use img.cdn and others files.cdn-buckets?](https://help.clatterlabs.com/code-buckets/public-files/public-link-hosts): Images get https://img.cdn.clatterlabs.xyz/, cached for a year. Everything else gets files.cdn-buckets.clatterlabs.xyz, cached 60 seconds. - [Why does my old files.cdn-buckets image link redirect?](https://help.clatterlabs.com/code-buckets/public-files/old-image-file-links): Older files-host links to images redirect (308) to the image's img.cdn.clatterlabs.xyz link. Add ?download=1 for the original. - [Why doesn't my image link contain the file name?](https://help.clatterlabs.com/code-buckets/public-files/image-links-opaque-id): Image links use an opaque 22-character id, with no file name, bucket or object id, so they don't reveal anything about your storage. - [Why don't scripts run in HTML or SVG files I made public?](https://help.clatterlabs.com/code-buckets/public-files/public-html-svg-safety): HTML, SVG and XML on the files host are served with a sandboxing Content-Security-Policy, so they can't run scripts on our domain. ### Code preview - [Can I edit files in the Code Buckets preview?](https://help.clatterlabs.com/code-buckets/code-preview/edit-files-in-preview): No. The preview is read-only. Change the code locally and upload a new zip (or a folder with target_path). - [Can I keep my Git history in Code Buckets?](https://help.clatterlabs.com/code-buckets/code-preview/store-git-history): Yes, inside the zip: a .git folder is stored in the encrypted zip, though the preview skips it. Code Buckets doesn't read Git history. - [Can I search inside my code in Code Buckets?](https://help.clatterlabs.com/code-buckets/code-preview/search-code-in-bucket): The Console's Files tab has a search box to find files. For full-text search, download the zip or the files and search locally. - [Does the unpacked preview count toward my storage?](https://help.clatterlabs.com/code-buckets/code-preview/preview-and-storage): The docs say storage counts stored zips and assets plus unfinished uploads. The preview tree isn't listed as counting. - [How are images and other binary files shown in the preview?](https://help.clatterlabs.com/code-buckets/code-preview/binary-files-in-preview): The file API returns binary files as base64 with binary: true. Add download=1 for raw bytes. - [How do I browse my code in the Console?](https://help.clatterlabs.com/code-buckets/code-preview/browse-code-in-console): Open the bucket and go to the Files tab. Search for a file and click it to see it with syntax highlighting. - [How do I list the files in my code with the API?](https://help.clatterlabs.com/code-buckets/code-preview/list-code-tree-api): GET /v1/buckets/{bucket_id}/tree returns every file and folder as flat paths, with the ref it read. - [How do I look at an older version of my code?](https://help.clatterlabs.com/code-buckets/code-preview/read-older-version): Find the ref in an earlier code.updated or backup event, then read the tree or files with ?ref=. - [How do I read one file from my code with the API?](https://help.clatterlabs.com/code-buckets/code-preview/read-a-file-api): GET /v1/buckets/{bucket_id}/files/{path} returns the content (UTF-8 or base64) and a detected language for highlighting. - [I get 400 bad_ref or bad_path. What's wrong?](https://help.clatterlabs.com/code-buckets/code-preview/bad-ref-or-path): ref must be exactly 40 hex characters, and path must be a file path in the tree with each segment URL-encoded. - [Is the preview copy of my code encrypted?](https://help.clatterlabs.com/code-buckets/code-preview/preview-not-encrypted): The preview tree is kept in private, access-controlled storage, but not encrypted with your bucket's key. Turn preview off if that matters. - [My zip's preview failed. Is my file lost?](https://help.clatterlabs.com/code-buckets/code-preview/preview-failed): No. A failed preview means the zip couldn't be read for unpacking; the zip itself is still stored and downloadable. - [Some files from my zip are missing in the preview. Why?](https://help.clatterlabs.com/code-buckets/code-preview/files-missing-from-preview): Large files, files past the per-zip limits, .git/, __MACOSX/, .DS_Store, unsafe paths and password-protected entries are skipped. - [What are the limits of code preview?](https://help.clatterlabs.com/code-buckets/code-preview/preview-limits): Files up to 2 MB each go into the tree, up to about 96 MB and 20,000 files per zip. Bigger files stay in the stored zip. - [What do the preview statuses mean?](https://help.clatterlabs.com/code-buckets/code-preview/preview-status-values): pending, extracting, ready, partial (some files only in the zip), failed (zip unreadable but stored) and off (preview disabled). - [What is a ref?](https://help.clatterlabs.com/code-buckets/code-preview/what-is-a-ref): A ref is a 40-character id for one version of a bucket's code tree. Reading with an explicit ref always returns the same content. - [What is code preview?](https://help.clatterlabs.com/code-buckets/code-preview/what-is-code-preview): When preview is on, uploaded zips unpack into a code tree you can browse with syntax highlighting in the Console or read over the API. - [Which languages does the code preview highlight?](https://help.clatterlabs.com/code-buckets/code-preview/preview-languages): The file API returns a detected language, like typescript, python or json, that the Console's viewer uses for highlighting. - [Why are some preview requests much faster than others?](https://help.clatterlabs.com/code-buckets/code-preview/preview-cached-with-ref): Requests with an explicit ?ref= never change, so they're cached at the edge and return in milliseconds. Pass the ref whenever you can. - [Why did the top folder of my zip disappear in the preview?](https://help.clatterlabs.com/code-buckets/code-preview/top-folder-stripped): If every file sits inside one top folder, like project-main/, that folder is dropped so files start at the root. preview.stripped_folder says which. - [Why isn't my .git folder in the preview?](https://help.clatterlabs.com/code-buckets/code-preview/preview-git-folder): .git/, __MACOSX/ and .DS_Store are always skipped from the code tree. They're still in the stored zip. ### Events feed - [Can I leave comments or notes on files in Code Buckets?](https://help.clatterlabs.com/code-buckets/events/no-comments-in-code-buckets): No. Code Buckets has no comments or threads; it uses an events feed instead. Use descriptions on projects and buckets for notes. - [Can I still see the history of a deleted bucket?](https://help.clatterlabs.com/code-buckets/events/events-for-deleted-bucket): The bucket.deleted event appears in the project's feed. The bucket's own feed isn't available once the bucket is gone. - [Can I use the events feed as an audit log?](https://help.clatterlabs.com/code-buckets/events/events-as-audit-log): Yes. Events record every change with who did it and when, in order. Export them regularly if you need long-term records. - [Does reading events cost tokens?](https://help.clatterlabs.com/code-buckets/events/events-cost-tokens): Each events request is 1 token. In the Console, browsing events is free. - [How can my script know when a new upload or code change happens?](https://help.clatterlabs.com/code-buckets/events/watch-for-new-uploads): Poll the bucket's events feed for upload.completed or code.updated, newest first, and remember the last event you've seen. - [How do I filter and page through events?](https://help.clatterlabs.com/code-buckets/events/filter-and-page-events): Use limit (up to 100), type (exact or a prefix like upload.), and before = next_before to get older pages. - [How do I see who made a change in a bucket?](https://help.clatterlabs.com/code-buckets/events/who-did-it-actor): Every event has an actor: the API key (id and name) that made the request, the Console, or Code Buckets itself. - [What event types are there?](https://help.clatterlabs.com/code-buckets/events/event-types-list): Every Code Buckets event type: projects, buckets, encryption, uploads, code updates, objects, visibility and backups. - [What is the events feed in Code Buckets?](https://help.clatterlabs.com/code-buckets/events/what-are-events): An ordered record of every action: uploads, code changes, deletions, backups, restores, visibility and settings changes, with who did it. - [What time zone are Code Buckets timestamps in?](https://help.clatterlabs.com/code-buckets/events/event-timestamps-time-zone): Timestamps are ISO 8601; the examples are UTC (ending in Z). The monthly token period also follows UTC. - [What's inside an event?](https://help.clatterlabs.com/code-buckets/events/event-fields): id, type, summary, project_id, bucket_id, actor, data and at. data holds type-specific details like refs and sizes. ### Backups, restore and versions - [Can I name my backups?](https://help.clatterlabs.com/code-buckets/backups/backup-name): Yes. Send a name (up to 80 characters) when creating a backup, like "Before checkout rewrite". It appears in events. - [Can I restore a backup into a different bucket?](https://help.clatterlabs.com/code-buckets/backups/restore-into-another-bucket): No. A restore applies to the bucket the backup was taken from. To copy, download the files and upload them elsewhere. - [Do backups cost tokens or storage?](https://help.clatterlabs.com/code-buckets/backups/backup-costs): Creating, restoring or deleting a backup is a normal API request: 1 token. Restoring is free and unlimited in count. - [Does Code Buckets keep versions of my files?](https://help.clatterlabs.com/code-buckets/backups/does-code-buckets-have-versioning): There's no per-file versioning. Each code tree version has a ref you can read later, and backups let you restore a bucket. - [Does my one backup cover all my buckets?](https://help.clatterlabs.com/code-buckets/backups/backup-across-buckets): No. A backup captures one bucket. The limit of 1 is per account, so it can protect one bucket at a time. - [How do I back up a bucket with the API?](https://help.clatterlabs.com/code-buckets/backups/create-a-backup): POST /v1/buckets/{bucket_id}/backups with a name, or use the bucket's backups in the Console. The key needs backups:write. - [How do I delete a backup?](https://help.clatterlabs.com/code-buckets/backups/delete-a-backup): DELETE /v1/backups/{backup_id} removes the backup and frees your backup slot. The bucket itself isn't touched. - [How do I make a bucket match a backup exactly?](https://help.clatterlabs.com/code-buckets/backups/restore-exact): Restore with {"objects": "exact"} to also hide files added after the backup, so the stored files match the backup exactly. - [How do I protect my code before letting a script or agent change it?](https://help.clatterlabs.com/code-buckets/backups/backup-before-agent-changes): Take a backup right before, give the tool a key without backups:write, and watch the events feed for what it did. - [How do I restore a backup with the API?](https://help.clatterlabs.com/code-buckets/backups/restore-a-backup): POST /v1/backups/{backup_id}/restore puts the backup's code back as a new version and brings back deleted files. Nothing is destroyed. - [How do I see my backups?](https://help.clatterlabs.com/code-buckets/backups/list-and-get-backups): GET /v1/buckets/{bucket_id}/backups lists a bucket's backups and your plan's backup usage; GET /v1/backups/{id} returns one. - [How many backups can I have?](https://help.clatterlabs.com/code-buckets/backups/how-many-backups): 1 backup per account, across all buckets, on every plan. Restoring is free and unlimited. Contact us if you need more. - [I get 409 backup_limit when creating a backup. What now?](https://help.clatterlabs.com/code-buckets/backups/backup-limit-409): You already have your 1 backup. Send "replace": true to replace it, or delete it first. error.existing_backup_id names it. - [I only get one backup. Which bucket should I back up?](https://help.clatterlabs.com/code-buckets/backups/which-bucket-to-back-up): Back up the bucket that would hurt most to lose, before risky changes, and keep your own downloads of other important buckets. - [If I delete a file after a backup, is it really gone?](https://help.clatterlabs.com/code-buckets/backups/backup-and-deleted-files): Not while the backup exists. The backup keeps pointing at the stored data, and restoring brings the file back. - [We need more backups for our company. What are our options?](https://help.clatterlabs.com/code-buckets/backups/backups-for-companies): Every plan includes 1 backup per account. Contact us for more, and meanwhile keep your own exports and refs. - [What does a backup capture?](https://help.clatterlabs.com/code-buckets/backups/what-is-a-backup): A backup captures a bucket's code tree (its ref) and the list of its stored zips and assets. Taking one is quick: nothing is copied. - [Will restoring a backup delete my current code?](https://help.clatterlabs.com/code-buckets/backups/restore-is-not-destructive): No. A restore adds the backup's tree as a new version; the current version stays reachable by its ref. Newer files are kept by default. - [Without a backup, can I still go back to older code?](https://help.clatterlabs.com/code-buckets/backups/backup-old-code-refs): Yes, for reading: older code tree versions stay readable by ref. Re-upload that version's zip to make it current again. ### Encryption and security - [Are uploads and downloads protected in transit?](https://help.clatterlabs.com/code-buckets/security/in-transit-security): Yes. All API, Console and public link traffic uses HTTPS (TLS). Add X-Content-SHA256 to chunks to verify integrity. - [Can Clatter Labs employees read my code?](https://help.clatterlabs.com/code-buckets/security/can-clatter-read-my-code): Files are encrypted at rest with per-bucket keys managed by Clatter Labs' servers, and access is restricted. See the Privacy Policy. - [Can I use my own encryption key for a bucket?](https://help.clatterlabs.com/code-buckets/security/can-i-bring-my-own-key): No. Each bucket's key is created and managed by Code Buckets. To control the key yourself, encrypt files before uploading. - [How are my files encrypted in Code Buckets?](https://help.clatterlabs.com/code-buckets/security/how-is-my-data-encrypted): Each 16 MiB chunk is encrypted with AES-256-GCM using the bucket's own 256-bit key, which is itself wrapped by a Clatter Labs master key. - [How do I report a security issue in Code Buckets?](https://help.clatterlabs.com/code-buckets/security/report-security-issue-code-buckets): Email infrastructure@clatterlabs.xyz or support@clatterlabs.com with details and steps to reproduce. Don't include working keys. - [How do I store files that only I can decrypt?](https://help.clatterlabs.com/code-buckets/security/end-to-end-encryption): Encrypt files on your side before uploading (for example with age or GPG), upload them as assets, and keep your key safe yourself. - [How quickly does revoking a key stop access to my buckets?](https://help.clatterlabs.com/code-buckets/security/revoke-code-buckets-key): Revoking a key in the Console stops it from working with Code Buckets within 30 seconds. - [How should I store sensitive or proprietary code?](https://help.clatterlabs.com/code-buckets/security/sensitive-code-checklist): Use a private bucket with preview off, a key with minimal permissions, never make files public, and consider encrypting before upload. - [I uploaded a zip that contains passwords or API keys. What should I do?](https://help.clatterlabs.com/code-buckets/security/secrets-in-uploaded-zip): Rotate the exposed secrets first, delete the object, check it isn't public, and deal with any backup that still covers it. - [Is Code Buckets suitable for regulated or confidential data?](https://help.clatterlabs.com/code-buckets/security/code-buckets-compliance): It encrypts files at rest with per-bucket keys and uses HTTPS. Review the Privacy Policy and Terms, and contact us about specific requirements. - [What stops someone tampering with my stored files?](https://help.clatterlabs.com/code-buckets/security/tamper-protection): AES-256-GCM authenticates every chunk and binds it to its object and position, so tampered or swapped chunks fail to decrypt. - [What's encrypted, and how, in Code Buckets?](https://help.clatterlabs.com/code-buckets/security/encryption-summary-table): A summary of protection for uploaded files, the preview tree, metadata, public files and traffic. - [Who can read the files in my buckets?](https://help.clatterlabs.com/code-buckets/security/who-can-read-my-buckets): Only requests with a valid API key and the matching Account ID, or your signed-in Console session, plus anyone with a link to a file you made public. ### Using the API - [Can I try the Code Buckets API from the docs?](https://help.clatterlabs.com/code-buckets/api/try-it-code-buckets): Yes. The API reference pages have Try it, sending real requests to api.codebuckets.clatterlabs.xyz with your key and Account ID. - [Can my web app upload directly to Code Buckets from the browser?](https://help.clatterlabs.com/code-buckets/api/code-buckets-in-browser-app): The API allows CORS, but keys must stay on your server. Upload through your backend, which calls Code Buckets with the key. - [Do I need jq or special tools to use the Code Buckets API?](https://help.clatterlabs.com/code-buckets/api/uploads-without-curl-jq): No. Any HTTP client works. The docs use cURL with jq and split for convenience, and show Python and JavaScript too. - [How can an AI agent or script use Code Buckets as storage?](https://help.clatterlabs.com/code-buckets/api/code-buckets-for-ai-agents): Give the agent a key with only the permissions it needs, a bucket of its own, and let it use the simple HTTPS API. - [How do I authenticate to the Code Buckets API?](https://help.clatterlabs.com/code-buckets/api/code-buckets-authentication): Send a Console API key (clsk_) as a bearer token and your Account ID in X-Clatter-Account on every request. - [How do I check my Code Buckets usage from the API?](https://help.clatterlabs.com/code-buckets/api/get-usage-api): GET /v1/usage returns this month's tokens, storage, backups and public file traffic. Works with buckets:read or account:read. - [How do I list the files stored in a bucket?](https://help.clatterlabs.com/code-buckets/api/list-objects): GET /v1/buckets/{bucket_id}/objects lists stored zips and assets, newest first, including unfinished uploads. Filter with kind. - [How do I see the details of one stored file?](https://help.clatterlabs.com/code-buckets/api/get-object-details): GET /v1/buckets/{bucket_id}/objects/{object_id} returns the object, its status, size, chunks, visibility, public link and preview result. - [How do I upload to Code Buckets from Windows PowerShell?](https://help.clatterlabs.com/code-buckets/api/windows-powershell-upload): For small files, use Invoke-RestMethod with the one-request upload. For big files, use the Python or Node uploader from the docs. - [How do I use Code Buckets from JavaScript or Node.js?](https://help.clatterlabs.com/code-buckets/api/code-buckets-from-javascript): Use fetch with the two headers on your server. The docs include a full Node.js uploader with parallel chunks and checksums. - [How do I use Code Buckets from Python?](https://help.clatterlabs.com/code-buckets/api/code-buckets-from-python): Use requests with the two headers. The docs include a complete resumable, parallel uploader in Python. - [How does paging work in the Code Buckets API?](https://help.clatterlabs.com/code-buckets/api/api-lists-and-paging): Lists return {object: list, data, has_more}, newest first. Pass the last item's created_at (or next_before for events) as before. - [How is the Code Buckets API versioned?](https://help.clatterlabs.com/code-buckets/api/api-version): The version is a date returned by GET / (currently 2026-10-28). Breaking changes get a new version and a changelog entry. - [What are the Code Buckets API rate limits?](https://help.clatterlabs.com/code-buckets/api/code-buckets-rate-limits): Each key allows 10, 30, 60 or 120 requests per minute. Chunk uploads and downloads don't count. Over the limit answers 429 rate_limited. - [What do the id prefixes cbp_, cbk_, cbo_, cbe_ and cbb_ mean?](https://help.clatterlabs.com/code-buckets/api/api-ids-prefixes): cbp_ is a project, cbk_ a bucket, cbo_ an upload or stored object, cbe_ an event, cbb_ a backup, and CL- your Account ID. - [What do the X-Codebuckets-Tokens and X-Request-Id headers mean?](https://help.clatterlabs.com/code-buckets/api/response-headers): X-Codebuckets-Tokens shows tokens used by the request; X-Request-Id identifies it for support; X-Content-SHA256 comes with chunk downloads. - [What does GET / on the Code Buckets API return?](https://help.clatterlabs.com/code-buckets/api/describe-service-get-root): It describes the service without a key, including the API version date. - [What does the Code Buckets API cover?](https://help.clatterlabs.com/code-buckets/api/code-buckets-api-overview): Base URL, authentication and every endpoint group: projects, buckets, uploads, objects, visibility, preview, backups and usage. - [What does the object field in Code Buckets responses mean?](https://help.clatterlabs.com/code-buckets/api/api-object-types): Every JSON object has an object field: project, bucket, upload, object, event, backup, tree, file or list. - [Which Code Buckets requests are safe to retry?](https://help.clatterlabs.com/code-buckets/api/code-buckets-idempotency): Chunk uploads, completing an upload and chunk operations are safe to repeat. Creating projects or buckets twice makes two. - [Which permissions do Code Buckets keys need?](https://help.clatterlabs.com/code-buckets/api/code-buckets-permissions): buckets:read to read and download, buckets:write to create, upload and delete, backups:write for backups, account:read for usage only. ### Using the Console - [Can I upload big files in the Console?](https://help.clatterlabs.com/code-buckets/console/console-upload-large-files): Yes, up to your bucket and plan limits. For very large or many files, the API's resumable uploads are more reliable. - [Can I use Code Buckets on my phone?](https://help.clatterlabs.com/code-buckets/console/console-on-phone): Yes. The Console works on phones, so you can browse buckets, read events and change visibility from a mobile browser. - [Can my teammates see my buckets in the Console?](https://help.clatterlabs.com/code-buckets/console/console-team-members): Team members work on the owner's plan within the access the owner sets in Console › Team. Otherwise buckets are visible only to your account. - [How do I copy a Project ID in the Console?](https://help.clatterlabs.com/code-buckets/console/console-copy-project-id): Open the project; the Project ID (cbp_…) is shown with a copy button on the project page. - [How do I make a file public or private in the Console?](https://help.clatterlabs.com/code-buckets/console/console-set-visibility): Open the bucket › Uploads & files, then choose Public, Private or Bucket default next to the file. - [How do I see a bucket's history in the Console?](https://help.clatterlabs.com/code-buckets/console/console-events-view): The project and bucket pages show their events feed: uploads, code changes, deletions, backups, restores and visibility changes. - [The Console keeps signing me out or won't load Code Buckets. What can I try?](https://help.clatterlabs.com/code-buckets/console/console-signed-out): Refresh, sign in again, allow cookies for console.clatterlabs.com, try another browser, and check status.clatterlabs.com. ### Pricing, storage and limits - [Can I buy more Code Buckets tokens?](https://help.clatterlabs.com/code-buckets/pricing-and-limits/buy-more-tokens): The docs don't list a token top-up. Every plan includes 1,000,000 a month; contact us if you need more. - [Do paid plans include more backups?](https://help.clatterlabs.com/code-buckets/pricing-and-limits/one-backup-every-plan): No. Every plan, from Free to Ultra, includes 1 backup per account. Contact us if you need more. - [How do I estimate how many tokens I'll use in a month?](https://help.clatterlabs.com/code-buckets/pricing-and-limits/estimate-monthly-tokens): Count requests plus MiB moved: uploads, downloads and public link traffic. Then compare with the 1,000,000 monthly allowance. - [How do I get more Code Buckets storage?](https://help.clatterlabs.com/code-buckets/pricing-and-limits/upgrade-for-more-storage): Move to a plan with more storage in Console › Billing › Plans, free up space, or contact us for more. - [How many tokens do common actions use?](https://help.clatterlabs.com/code-buckets/pricing-and-limits/token-examples): Listing projects is 1 token; a 100 MiB zip upload is about 109; downloading a 1 GB file is about 1,025. - [How much does Code Buckets cost?](https://help.clatterlabs.com/code-buckets/pricing-and-limits/code-buckets-pricing): Every plan includes 1,000,000 tokens a month and 1 backup. Storage depends on plan: 1 GB Free up to 1 TB Ultra. - [I get 413 too_large on a normal API call. Why?](https://help.clatterlabs.com/code-buckets/pricing-and-limits/json-body-limit): JSON request bodies are limited to 16 KB, and the one-request upload to 4 MiB. Shorten the body or use chunked uploads. - [Is Code Buckets storage unlimited?](https://help.clatterlabs.com/code-buckets/pricing-and-limits/is-code-buckets-unlimited): No. Storage depends on your plan (1 GB to 1 TB), each bucket holds up to 10 GB, and there are 1,000,000 tokens a month. - [We need more than the published Code Buckets limits. Who do we talk to?](https://help.clatterlabs.com/code-buckets/pricing-and-limits/need-more-than-limits): Contact us through the Support Center or email support@clatterlabs.com with your Account ID and what you need. - [What are all the Code Buckets limits?](https://help.clatterlabs.com/code-buckets/pricing-and-limits/code-buckets-limits-table): Every limit: storage per bucket, chunk size, chunks per file, download size, projects, buckets, preview, names, bodies and rate limits. - [What counts toward my storage?](https://help.clatterlabs.com/code-buckets/pricing-and-limits/storage-counts-what): Stored zips and assets plus space reserved by unfinished uploads count. Deleting an object frees its space. - [What is a Code Buckets token?](https://help.clatterlabs.com/code-buckets/pricing-and-limits/what-is-a-code-buckets-token): The unit of usage: 1 per API request plus 1 per MiB uploaded or downloaded. JSON bodies cost only the request token. - [When do my monthly Code Buckets tokens reset?](https://help.clatterlabs.com/code-buckets/pricing-and-limits/monthly-tokens-reset): On the 1st of each UTC calendar month. Until then, requests past the allowance answer 402 quota_exceeded. - [Why did I use more tokens than I expected?](https://help.clatterlabs.com/code-buckets/pricing-and-limits/tokens-higher-than-expected): Rounding per request, public link traffic, Console uploads and downloads, polling, and re-downloading large files all add up. - [Why does my usage show "unlimited"?](https://help.clatterlabs.com/code-buckets/pricing-and-limits/team-accounts-unlimited-code-buckets): Unlimited plans in usage data apply to Clatter Labs' own team accounts. Regular accounts show the included amounts for their plan. - [Will my Free plan Code Buckets storage stay free?](https://help.clatterlabs.com/code-buckets/pricing-and-limits/code-buckets-free-forever): The Free plan currently includes 1 GB, 1,000,000 tokens a month and 1 backup. Pricing can change; check the pricing page and changelog. ### Deleting files and data - [Can I delete only my Code Buckets data and keep my Clatter Labs account?](https://help.clatterlabs.com/code-buckets/deleting-data/delete-one-service-not-account): Yes. Delete your buckets and projects, and email infrastructure@clatterlabs.xyz to permanently delete one service's data. - [Can I rename a file after uploading it?](https://help.clatterlabs.com/code-buckets/deleting-data/rename-file-after-upload): No. There's no rename for objects. Upload it again with the new name and delete the old one. - [How do I delete a file from a bucket?](https://help.clatterlabs.com/code-buckets/deleting-data/delete-a-file): DELETE /v1/buckets/{bucket_id}/objects/{object_id} removes a stored zip or asset and frees its space. The code tree isn't changed. - [How do I delete many files at once?](https://help.clatterlabs.com/code-buckets/deleting-data/bulk-delete-files): List the objects and delete each with the API. There's no single bulk-delete request. - [How do I permanently delete all my Code Buckets data?](https://help.clatterlabs.com/code-buckets/deleting-data/permanently-delete-my-data): Delete your buckets and projects, delete your backup, then email infrastructure@clatterlabs.xyz to request permanent deletion. - [How long is deleted data kept?](https://help.clatterlabs.com/code-buckets/deleting-data/retention-after-deletion): The docs don't publish a retention period after deletion. For guaranteed permanent erasure, email infrastructure@clatterlabs.xyz. - [I deleted a public image. Why can some people still see it?](https://help.clatterlabs.com/code-buckets/deleting-data/delete-public-file-cache): Deleting turns the link off immediately for new requests, but browsers that already loaded the image may show their cached copy. - [I deleted a zip, but its code still shows in the preview. Why?](https://help.clatterlabs.com/code-buckets/deleting-data/deleting-zip-keeps-preview): Deleting a stored object doesn't change the code tree. Upload a new zip to replace the tree, or create a fresh bucket. - [What happens to my buckets if I delete my Clatter Labs account?](https://help.clatterlabs.com/code-buckets/deleting-data/delete-account-with-buckets): Your Code Buckets data belongs to your account. Download what you need first, and ask infrastructure@clatterlabs.xyz for permanent deletion. - [What's the difference between aborting an upload and deleting an object?](https://help.clatterlabs.com/code-buckets/deleting-data/abort-vs-delete): Abort cancels an unfinished upload and frees reserved space. Delete removes a finished, stored file. ### Troubleshooting - [Code Buckets says 404 not_found but I know the id exists. Why?](https://help.clatterlabs.com/code-buckets/troubleshooting/cb-not-found): The id isn't on the account in X-Clatter-Account, it was deleted, or you used the wrong kind of id for the endpoint. - [I can't see buckets I created. Am I on the wrong account?](https://help.clatterlabs.com/code-buckets/troubleshooting/cb-wrong-account-files): Buckets belong to one account. Check which account you're signed in to in the Console and which Account ID your key uses. - [I get 401 errors from the Code Buckets API. How do I fix them?](https://help.clatterlabs.com/code-buckets/troubleshooting/cb-401-errors): invalid_api_key, expired_api_key, missing_account_id or account_mismatch: check the key, its status and the X-Clatter-Account header. - [I get network errors calling api.codebuckets.clatterlabs.xyz. What can I check?](https://help.clatterlabs.com/code-buckets/troubleshooting/cb-cors-or-network-error): Check your network or proxy allows the host, that you call it from a server, and that GET / answers. Then check the status page. - [I keep getting 400 checksum_mismatch. What's wrong?](https://help.clatterlabs.com/code-buckets/troubleshooting/checksum-mismatch): The chunk's bytes don't match the X-Content-SHA256 you sent. Hash exactly the chunk bytes in hex, then resend. - [I restored a backup but some newer files are still there. Why?](https://help.clatterlabs.com/code-buckets/troubleshooting/backup-restore-not-what-expected): By default a restore keeps files added after the backup. Restore again with {"objects": "exact"} to hide them. - [I uploaded files to the wrong bucket. How do I fix it?](https://help.clatterlabs.com/code-buckets/troubleshooting/upload-wrong-bucket): Upload them again to the right bucket, then delete the objects from the wrong one. There's no move between buckets. - [I uploaded my code but the Files tab is empty. Why?](https://help.clatterlabs.com/code-buckets/troubleshooting/preview-empty-after-upload): The file was stored as an asset, preview is off, the zip is still processing, or its preview failed. Here's how to tell. - [My big monorepo zip only partly appears in the preview. What can I do?](https://help.clatterlabs.com/code-buckets/troubleshooting/cb-large-zip-partial): Preview takes about 96 MB of files and 20,000 files per zip. Split the repo into smaller zips with target_path, or across buckets. - [My files.cdn-buckets link shows an old version for a minute. Why?](https://help.clatterlabs.com/code-buckets/troubleshooting/public-link-shows-old-file): Files on that host are cached for up to 60 seconds. Each upload is a new object with a new link, so use the new public_url. - [My image's public link is on files.cdn-buckets, not img.cdn. Why?](https://help.clatterlabs.com/code-buckets/troubleshooting/image-not-on-image-host): It wasn't recognised as an image: its content_type isn't image/* and its extension isn't an image one. Re-upload with an image content_type. - [My key works on my laptop but gets 401 from a hosted environment. Why?](https://help.clatterlabs.com/code-buckets/troubleshooting/code-buckets-from-sandbox-401): Something in that environment may be rewriting the Authorization header, such as a proxy that injects its own credentials. - [My public file downloads instead of opening, or shows as text. Why?](https://help.clatterlabs.com/code-buckets/troubleshooting/wrong-content-type): Its Content-Type is wrong. It comes from content_type at upload, or the extension. Re-upload with the right content_type. - [My upload is stuck on "uploading". How do I finish it?](https://help.clatterlabs.com/code-buckets/troubleshooting/upload-stuck-uploading): Check received_chunks, send the missing chunks and call complete. Uploads stay uploading until they're completed or aborted. - [My uploads are slow. How can I speed them up?](https://help.clatterlabs.com/code-buckets/troubleshooting/slow-uploads): Upload 3–4 chunks in parallel, retry single failed chunks, avoid restarting, and shrink zips by leaving out dependencies and build output. - [My zip has been "processing" for a long time. What's happening?](https://help.clatterlabs.com/code-buckets/troubleshooting/zip-stuck-processing): Building the code tree usually takes seconds, longer for very large zips. Check preview.status and the events feed; the zip itself is stored. - [The tree response says truncated: true. What does that mean?](https://help.clatterlabs.com/code-buckets/troubleshooting/tree-truncated): Very large trees (over 100,000 entries) are truncated in the listing. Read specific files by path, or split code across buckets. - [What do 503 unavailable and storage_unavailable mean?](https://help.clatterlabs.com/code-buckets/troubleshooting/cb-503-unavailable): The service or its storage is briefly unavailable. Retry in a moment with backoff and check the status page if it continues. - [What do all the Code Buckets error codes mean?](https://help.clatterlabs.com/code-buckets/troubleshooting/code-buckets-error-codes): Every Code Buckets error code with its status and what to do, in one table. - [What should I do about 502 storage_error?](https://help.clatterlabs.com/code-buckets/troubleshooting/storage-error-502): Storage had a temporary problem with that operation. Retry it; chunk operations are safe to repeat. - [What should I include when contacting support about Code Buckets?](https://help.clatterlabs.com/code-buckets/troubleshooting/cb-contact-support): Your Account ID, the project, bucket or object ids, the X-Request-Id, the time, the endpoint and the error code. Never your key. ## Community Posting, moderation and your account on the Clatter Labs Community. ### Community closure - [An old Community link doesn't work. Why?](https://help.clatterlabs.com/community/closure/old-community-links): Every page on community.clatterlabs.com now shows the closure notice, so links to old posts and profiles no longer open them. - [Community still appears in my connected apps. Should I remove it?](https://help.clatterlabs.com/community/closure/community-sign-in-still-listed): You can. The Community app no longer does anything, and revoking it in Connected apps simply tidies your account. - [Does the Community closing affect my Clatter Labs account?](https://help.clatterlabs.com/community/closure/does-closure-affect-my-account): No. The same Clatter Labs account still signs you in to every other Clatter Labs product. - [I used to post on the Community. Where did it go?](https://help.clatterlabs.com/community/closure/community-for-kids): The Community website is closed. Your account still works, and you can ask questions at the Support Center instead. - [Is Clatter Labs Community closed?](https://help.clatterlabs.com/community/closure/is-community-closed): Yes. Clatter Labs Community is no longer open, and posts and discussions are no longer available on community.clatterlabs.com. - [Where can I ask questions now that the Community is closed?](https://help.clatterlabs.com/community/closure/where-to-ask-questions-now): Use the Support Center for help, the developer docs for guides, and email support for anything a person should look at. - [Why did Clatter Labs Community close?](https://help.clatterlabs.com/community/closure/why-did-community-close): Clatter Labs closed the Community to focus on its developer products. No reopening plan has been announced. - [Will the Community open again?](https://help.clatterlabs.com/community/closure/will-community-reopen): No reopening date or plan has been announced for Clatter Labs Community. ### Your Community content and data - [Can I appeal an old Community moderation decision?](https://help.clatterlabs.com/community/your-content/moderation-history): The Community is closed, but you can still contact support about a past moderation decision or a restriction on your account. - [Can I get a copy of my Community posts?](https://help.clatterlabs.com/community/your-content/get-a-copy-of-my-posts): Use Download your data in your account center, or ask support for a copy of your Community data under your right of access. - [Can I have my Community data deleted?](https://help.clatterlabs.com/community/your-content/delete-community-data): Yes. Email infrastructure@clatterlabs.xyz to permanently delete your Community data only, or delete your whole Clatter Labs account. - [My old Community post still shows up in search engines](https://help.clatterlabs.com/community/your-content/community-posts-in-search-results): Search engines can keep showing old snapshots for a while after a site closes. The page itself now shows the closure notice. - [Someone posted my personal information on the Community. What can I do?](https://help.clatterlabs.com/community/your-content/someone-posted-my-info): Ask Clatter Labs to remove it. The Community rules never allowed posting other people's personal data without permission. - [Was my Community profile picture separate from my account picture?](https://help.clatterlabs.com/community/your-content/my-profile-picture-on-community): Your Community profile used your Clatter Labs account name and picture. Change or remove them in the account center. - [What happened to my Community posts?](https://help.clatterlabs.com/community/your-content/what-happened-to-my-posts): Posts and discussions are no longer shown on community.clatterlabs.com. You can request a copy or permanent deletion of your data. ## Security & privacy Your data, backups, retention, deletion, the abuse policy, responsible disclosure and legal. ### Data we collect - [Does anyone at Clatter Labs read my prompts or files?](https://help.clatterlabs.com/security-privacy/data-we-collect/does-clatter-labs-read-my-files): Only authorised people, only when needed: for support you ask for, security or abuse investigations, enforcing the Terms, or the law. - [Does Clatter Labs collect sensitive data like health or religion?](https://help.clatterlabs.com/security-privacy/data-we-collect/do-you-collect-sensitive-data): Not on purpose. Please don't put sensitive personal data in prompts or files unless you need to. - [Does Clatter Labs get data about me from other places?](https://help.clatterlabs.com/security-privacy/data-we-collect/data-from-third-parties): Only from sign-in providers you choose, services you connect, a team owner who invites you, and other users who mention you. - [Does Clatter Labs see my card number?](https://help.clatterlabs.com/security-privacy/data-we-collect/billing-data-collected): No. Payments go through Gumroad as merchant of record. We get purchase details like email, product and amount, never your full card number. - [What data does Clatter Labs collect about me?](https://help.clatterlabs.com/security-privacy/data-we-collect/what-data-does-clatter-labs-collect): Account details, sign-in and device data, what you send to our AI tools, files you store, usage and billing records, and support messages. - [What does Cosmos Agent store about my tasks?](https://help.clatterlabs.com/security-privacy/data-we-collect/cosmos-agent-what-is-stored): Tasks, the agent's actions, files, screenshots and browsing during a session, plus memories, reminders and settings you create. - [What happens to the messages I send to support?](https://help.clatterlabs.com/security-privacy/data-we-collect/support-messages-data): We use them to help you and keep support records for up to 24 months after your request is closed. - [What happens to what I write in an early-access request?](https://help.clatterlabs.com/security-privacy/data-we-collect/early-access-form-data): It's used to review your request, possibly with automated scoring, and deleted within 12 months if not accepted. - [What shouldn't I put in my prompts?](https://help.clatterlabs.com/security-privacy/data-we-collect/what-not-to-put-in-prompts): Avoid passwords, secrets, government IDs, financial account numbers and sensitive personal data unless your task truly needs them. - [Why does Clatter Labs collect my IP address?](https://help.clatterlabs.com/security-privacy/data-we-collect/why-collect-ip-address): For security, new-device alerts, abuse prevention, location-based restrictions and running the service. It's kept in logs for a limited time. ### How we use your data - [Are my prompts anonymous?](https://help.clatterlabs.com/security-privacy/how-we-use-data/are-my-prompts-anonymous): No. They're pseudonymized (linked to an internal ID instead of your name or email), but prompts can still contain personal data. - [Can I create images or content about real people?](https://help.clatterlabs.com/security-privacy/how-we-use-data/images-of-real-people): Not sexual content without consent, deceptive deepfakes, or harassment. Verify any factual claims about real people before publishing. - [Can I find out who my data was shared with?](https://help.clatterlabs.com/security-privacy/how-we-use-data/who-received-my-data): Yes. Ask through a privacy request. We tell you who received your data, and inform recipients of corrections or deletions where feasible. - [Can I put other people's personal information into prompts?](https://help.clatterlabs.com/security-privacy/how-we-use-data/other-peoples-data-in-prompts): Only if you have the right to. You're responsible for any personal data of others you include, so share only what you need. - [Can I use Clatter Labs for health, financial or other sensitive data?](https://help.clatterlabs.com/security-privacy/how-we-use-data/sensitive-industries): Only with a lawful basis and the safeguards your law requires. Clatter Labs doesn't claim specific industry certifications. - [Can I use Clatter Labs to make decisions about people, like hiring?](https://help.clatterlabs.com/security-privacy/how-we-use-data/automated-decisions-about-people): Not without appropriate human review and compliance with the law. Decisions on credit, jobs, housing or education need a human in the loop. - [Does Clatter Labs make automated decisions about me?](https://help.clatterlabs.com/security-privacy/how-we-use-data/automated-decisions): Only for early-access scoring and abuse, fraud and security detection. You can always ask for a human to review. - [Does Clatter Labs scan my requests automatically?](https://help.clatterlabs.com/security-privacy/how-we-use-data/automated-abuse-checks): Yes. Automated safety and abuse checks, such as rate limits and checks for prohibited use, may process request content. - [Does Clatter Labs sell my data?](https://help.clatterlabs.com/security-privacy/how-we-use-data/do-you-sell-my-data): No. We don't sell personal data, don't show ads and don't use advertising trackers. - [Does Clatter Labs use anonymous statistics?](https://help.clatterlabs.com/security-privacy/how-we-use-data/aggregated-data): Yes. Aggregated or de-identified data that doesn't identify you may be used for any lawful purpose, like reliability stats. - [On what legal basis does Clatter Labs process my data?](https://help.clatterlabs.com/security-privacy/how-we-use-data/legal-bases): Mainly contract (to provide the service), legitimate interests (security, improvement, training), legal obligations and consent. - [What does "pseudonymized" mean?](https://help.clatterlabs.com/security-privacy/how-we-use-data/what-is-pseudonymization): It means replacing who you are (name, email) with an internal code, so data isn't directly linked to you, though it isn't fully anonymous. - [What does Clatter Labs do if the government asks for my data?](https://help.clatterlabs.com/security-privacy/how-we-use-data/government-requests): We check that the request is legally valid, disclose only the minimum required and tell you first where the law allows. - [What does Clatter Labs use my data for?](https://help.clatterlabs.com/security-privacy/how-we-use-data/what-is-my-data-used-for): To run the products, keep them secure, bill you, support you, meet legal duties, improve services and train our own models. - [What happens to my data if Clatter Labs is sold or merges?](https://help.clatterlabs.com/security-privacy/how-we-use-data/merger-acquisition): Data may move to the other company under confidentiality, and you'll be told before your data falls under a different privacy policy. - [Who does Clatter Labs share my data with?](https://help.clatterlabs.com/security-privacy/how-we-use-data/who-do-you-share-data-with): Infrastructure providers that run our services, apps you choose to connect, payment provider Gumroad, advisers, and authorities when the law requires. ### Model training - [Are my API keys and passwords removed before training?](https://help.clatterlabs.com/security-privacy/model-training/are-secrets-filtered-from-training): Automated filters try to remove secrets and credentials, but may miss some. Don't paste secrets into prompts, and rotate any you did. - [Can a model "forget" my data after it was trained?](https://help.clatterlabs.com/security-privacy/model-training/can-models-forget): No. Models already trained can't be changed to remove what they learned. Objecting stops future use. - [Can my company opt out of training for our whole team?](https://help.clatterlabs.com/security-privacy/model-training/team-training-objection): Yes. The team owner or any member can object. Enterprise agreements can also set different terms. - [Could my code show up in someone else's answers?](https://help.clatterlabs.com/security-privacy/model-training/does-training-affect-my-outputs): Outputs may resemble what others get. Training data is pseudonymized and filtered, but keep confidential code out of prompts if that worries you. - [Does Clatter Labs train AI models on my data?](https://help.clatterlabs.com/security-privacy/model-training/does-clatter-labs-train-on-my-data): Yes. Pseudonymized prompts, outputs, files and agent sessions, with secrets filtered out, help train our own models. You can object. - [How do I opt out of model training?](https://help.clatterlabs.com/security-privacy/model-training/how-to-opt-out-of-training): Send a request at support.clatterlabs.com saying you object to model training and identifying your account, for example by email. - [How is my content prepared before it's used for training?](https://help.clatterlabs.com/security-privacy/model-training/how-training-data-is-prepared): It's pseudonymized and passed through automated filters that remove secrets and credentials. Filters aren't perfect. - [Is content from teenagers used for training?](https://help.clatterlabs.com/security-privacy/model-training/under-18-not-used-for-training): No. Clatter Labs doesn't use content from users it knows are under 18 to train models. - [What happens after I object to model training?](https://help.clatterlabs.com/security-privacy/model-training/what-happens-after-opting-out): Within a month we stop adding your content and remove it from unused datasets where identifiable. Already-trained models can't unlearn. - [Why isn't there a toggle to turn off training?](https://help.clatterlabs.com/security-privacy/model-training/opt-out-no-setting): There's no in-product setting today. Objections are handled by request through the Support Center. ### Where your data lives - [Can I choose which country or region my data is stored in?](https://help.clatterlabs.com/security-privacy/data-location/can-i-choose-data-region): Not by default. Data residency isn't guaranteed unless agreed in writing, and AI inference is in the United States. - [How is my data protected when it's sent to other countries?](https://help.clatterlabs.com/security-privacy/data-location/international-transfers): With recognised safeguards such as EU Standard Contractual Clauses, the UK addendum, encryption and pseudonymization. - [Is my data stored in Egypt?](https://help.clatterlabs.com/security-privacy/data-location/is-data-stored-in-egypt): No. Clatter Labs is based in Egypt, but its servers are not located in Egypt. Data is processed mainly in the EU and the US. - [What are sub-processors, and can I see the list?](https://help.clatterlabs.com/security-privacy/data-location/what-are-sub-processors): Sub-processors are companies that help run our services. A current list is available on request through a privacy request. - [Where do Cosmos Agent's cloud computers run?](https://help.clatterlabs.com/security-privacy/data-location/where-are-cosmos-agent-computers): On Clatter Labs infrastructure, isolated per account. Websites the agent visits see our infrastructure's IP address. - [Where is my data stored?](https://help.clatterlabs.com/security-privacy/data-location/where-is-my-data-stored): Mostly in Europe and the United States, on Clatter Labs infrastructure run by leading cloud providers. AI inference happens in the United States. - [Which outside companies handle my data?](https://help.clatterlabs.com/security-privacy/data-location/who-uses-my-data-outside-clatter): Cloud infrastructure providers, Gumroad for payments, GitHub for repositories used by agent features, and Telegram if you link the bot. ### Encryption and protection - [Do Clatter Labs websites and APIs all use HTTPS?](https://help.clatterlabs.com/security-privacy/encryption/https-everywhere): Yes. Data in transit is encrypted with TLS, and all API and Console traffic uses HTTPS. - [How are passwords stored?](https://help.clatterlabs.com/security-privacy/encryption/how-are-passwords-stored): Only as salted hashes, never in readable form. Nobody at Clatter Labs can see your password. - [How are tokens for connected services protected?](https://help.clatterlabs.com/security-privacy/encryption/connector-tokens-security): They're encrypted separately, used only for actions you ask for, never exported or shown in full, and deleted when you disconnect. - [How does Clatter Labs protect my data?](https://help.clatterlabs.com/security-privacy/encryption/how-is-my-data-protected): Encryption in transit and at rest, extra encryption for secrets, strict access controls, network protections and monitoring. - [How does Clatter Labs store my API keys?](https://help.clatterlabs.com/security-privacy/encryption/how-are-api-keys-stored): Keys are shown once, then kept only as a keyed hash or encrypted form. They can't be shown again, so a lost key must be replaced. - [Is Clatter Labs ISO 27001 or SOC 2 certified?](https://help.clatterlabs.com/security-privacy/encryption/are-you-iso-certified): No certification is claimed. Clatter Labs aligns its practices with ISO/IEC 27001, 27701 and 42001 and uses the GDPR as its baseline. - [Is my data encrypted?](https://help.clatterlabs.com/security-privacy/encryption/is-my-data-encrypted): Yes. Data is encrypted in transit with TLS and at rest. Passwords, tokens and secrets get additional protection. - [Is my information safe with Clatter Labs? (simple answer)](https://help.clatterlabs.com/security-privacy/encryption/is-clatter-labs-safe-for-kids): Your information is locked with encryption and only a few authorised people can reach it. You can help by keeping your password and codes secret. - [Is traffic between Line CLI and Clatter Labs encrypted?](https://help.clatterlabs.com/security-privacy/encryption/is-line-cli-traffic-encrypted): Yes. Line CLI sends prompts and file excerpts over an encrypted connection, and tries to redact secrets first. - [Who at Clatter Labs can access my data?](https://help.clatterlabs.com/security-privacy/encryption/who-can-access-my-data): Only authorised personnel on a need-to-know basis, with administrative access restricted to named accounts. ### Backups - [Are backups encrypted?](https://help.clatterlabs.com/security-privacy/backups/backups-and-encryption): Data at rest, including stored data that backups point to, is encrypted. Deleted data waiting in backups is protected and not used. - [Can Clatter Labs restore something I deleted from a backup?](https://help.clatterlabs.com/security-privacy/backups/can-you-restore-from-backup): Don't count on it. System backups protect the service, not individual restores. Use Code Buckets backups and scheduled deletion as safety nets. - [Does Clatter Labs back up my data?](https://help.clatterlabs.com/security-privacy/backups/does-clatter-labs-back-up-my-data): Yes. Backups run on a rolling cycle of up to 90 days. Code Buckets also lets you create your own backups. - [How can I keep my own backup of my Clatter Labs data?](https://help.clatterlabs.com/security-privacy/backups/backup-my-own-data): Download your account data, download Code Buckets files, and keep Line CLI work in Git on your own machine. - [Is my deleted data still in backups?](https://help.clatterlabs.com/security-privacy/backups/deleted-data-in-backups): It can be, for up to 90 days, until backups are overwritten. During that time it's protected and not used. ### Data retention - [How long are early-access requests kept?](https://help.clatterlabs.com/security-privacy/retention/how-long-early-access-requests-are-kept): Requests that aren't accepted are deleted within 12 months. - [How long are logs kept?](https://help.clatterlabs.com/security-privacy/retention/how-long-are-logs-kept): Request logs and telemetry are kept up to 90 days, and security logs up to 12 months. Logs avoid passwords, tokens and full prompts. - [How long are my Cosmos Agent sessions and files kept?](https://help.clatterlabs.com/security-privacy/retention/how-long-is-agent-data-kept): With your account until you delete them or the account, unless a service states a shorter period. - [How long are my payment records kept?](https://help.clatterlabs.com/security-privacy/retention/how-long-are-billing-records-kept): As long as billing, disputes and tax law require, disconnected from your identity where the law allows. - [How long does Clatter Labs keep my data?](https://help.clatterlabs.com/security-privacy/retention/how-long-is-my-data-kept): Account data while your account exists; logs up to 90 days; security logs up to 12 months; support records up to 24 months; backups up to 90 days. - [How long does Clatter Labs keep my support conversations?](https://help.clatterlabs.com/security-privacy/retention/support-records): Up to 24 months after the request is closed. - [How long does Clatter Labs keep the message that got me a strike?](https://help.clatterlabs.com/security-privacy/retention/how-long-are-abuse-excerpts-kept): A short, redacted excerpt (no code, no links) is kept per strike and erased after 30 days. - [What does Clatter Labs keep after I delete my account?](https://help.clatterlabs.com/security-privacy/retention/what-stays-after-deletion): A minimal deletion record for up to 35 days, legally required billing records, data in backups until overwritten, and already-trained models. - [What happens to my data if I stop using Clatter Labs?](https://help.clatterlabs.com/security-privacy/retention/inactive-data): It stays while your account exists. Free accounts inactive over 24 months may be closed after 30 days' notice, then data is deleted. - [What happens to my data when a Clatter Labs product shuts down?](https://help.clatterlabs.com/security-privacy/retention/service-shutdown-data): We tell you in advance where practicable, give you a chance to export, then delete the related data unless the law requires keeping it. ### Deleting your data - [Can I delete individual files, chats or memories?](https://help.clatterlabs.com/security-privacy/deletion/delete-specific-content): Yes. Delete Code Buckets objects and backups, agent memories and reminders, connectors and keys yourself; ask us for the rest. - [Do I have a "right to be forgotten"?](https://help.clatterlabs.com/security-privacy/deletion/right-to-be-forgotten): Yes. You can ask for erasure of your personal data where the law provides, and Clatter Labs extends this to all users where practicable. - [Does deleting my account remove my data from AI training?](https://help.clatterlabs.com/security-privacy/deletion/does-deleting-account-remove-training-data): Your content stops being used and is removed from unused datasets where identifiable. Models already trained can't be changed. - [How do I delete my data from Clatter Labs?](https://help.clatterlabs.com/security-privacy/deletion/how-to-delete-my-data): Delete specific items yourself, delete one service's data via infrastructure@clatterlabs.xyz, or delete your whole account in the account center. - [How do I disconnect a connected service and delete its token?](https://help.clatterlabs.com/security-privacy/deletion/disconnect-a-connector): Disconnect it in your settings; we delete the stored tokens. You can also revoke access in the other service. - [How do I get my stuff deleted? (simple steps)](https://help.clatterlabs.com/security-privacy/deletion/delete-data-for-kids): Ask a parent or guardian to help you delete your account, or email us and we'll delete your information. - [How do I permanently delete my data from one service but keep my account?](https://help.clatterlabs.com/security-privacy/deletion/delete-data-from-one-service): Email infrastructure@clatterlabs.xyz from your account email with your Account ID and the service. We verify and delete it permanently. - [How long does it take to delete my data?](https://help.clatterlabs.com/security-privacy/deletion/how-long-does-deletion-take): Deletion starts promptly. A minimal record stays up to 35 days, and backups are overwritten within 90 days. - [Someone else put my personal data into Clatter Labs. Can I get it deleted?](https://help.clatterlabs.com/security-privacy/deletion/delete-someone-elses-data): Yes. Send a privacy request describing where it appears. If it's in a company's team, we may refer you to that company. - [Will I get confirmation that my data was deleted?](https://help.clatterlabs.com/security-privacy/deletion/deletion-confirmation): The account center confirms scheduled or immediate deletion. For emailed requests, we reply when the deletion is done. ### Your privacy rights - [Can I complain to a data protection authority?](https://help.clatterlabs.com/security-privacy/your-rights/complain-to-regulator): Yes. You can complain to the authority where you live or work, or in Egypt to the Personal Data Protection Center. - [Can I move my data to another service?](https://help.clatterlabs.com/security-privacy/your-rights/data-portability): Yes. Your export is structured, machine-readable JSON, and you can ask us to transmit data to another controller where feasible. - [Can I object to how Clatter Labs uses my data?](https://help.clatterlabs.com/security-privacy/your-rights/right-to-object): Yes. You can object to legitimate-interest processing, and to model training at any time without giving a reason. - [Can someone else make a privacy request for me?](https://help.clatterlabs.com/security-privacy/your-rights/someone-else-makes-request): California residents may use an authorised agent. Parents can act for children. We may verify both the agent's authority and your identity. - [Does Clatter Labs have an EU or UK representative?](https://help.clatterlabs.com/security-privacy/your-rights/eu-uk-representative): EU and UK users can contact Clatter Labs directly through the privacy contact. A representative will be named if the law requires one. - [Does the GDPR apply even though Clatter Labs isn't in the EU?](https://help.clatterlabs.com/security-privacy/your-rights/gdpr-outside-eu): Clatter Labs applies GDPR principles as its global baseline for all users and follows GDPR where it applies by law. - [How do I correct wrong information about me?](https://help.clatterlabs.com/security-privacy/your-rights/right-to-correct): Edit your name and picture yourself; for anything else, send a privacy request saying what's wrong. - [How do I get a copy of the data Clatter Labs holds about me?](https://help.clatterlabs.com/security-privacy/your-rights/right-to-access-my-data): Use Download your data for a .zip of your account data, or send a privacy request for anything not included. - [How do I make a privacy request?](https://help.clatterlabs.com/security-privacy/your-rights/how-to-make-a-privacy-request): Use account settings for downloads and deletion, or open a request at support.clatterlabs.com marked as a privacy request. - [How do I use my right to erasure?](https://help.clatterlabs.com/security-privacy/your-rights/right-to-erasure): Delete your account yourself, or ask infrastructure@clatterlabs.xyz to delete one service's data or everything. - [How do I withdraw my consent?](https://help.clatterlabs.com/security-privacy/your-rights/withdraw-consent): Use the unsubscribe link for optional emails, or send a privacy request. Withdrawing doesn't affect processing done before. - [How long does Clatter Labs take to answer a privacy request?](https://help.clatterlabs.com/security-privacy/your-rights/how-long-to-answer-privacy-request): Within one month, extendable by two more months for complex requests, with notice in the first month. - [What are my privacy rights in California?](https://help.clatterlabs.com/security-privacy/your-rights/california-privacy-rights): Right to know, delete, correct, opt out of sale or sharing and limit sensitive data use. We confirm in 10 business days and respond in 45. - [What if my country's law gives me more rights than the Privacy Policy?](https://help.clatterlabs.com/security-privacy/your-rights/local-law-gives-more-rights): Then your law wins. The Privacy Policy never limits mandatory rights, and stricter law prevails. - [What is the right to restrict processing?](https://help.clatterlabs.com/security-privacy/your-rights/right-to-restrict): You can ask us to limit how your data is used, for example while we check its accuracy or consider your objection. - [What privacy rights do I have?](https://help.clatterlabs.com/security-privacy/your-rights/what-are-my-privacy-rights): Access, correction, erasure, restriction, portability, objection, rights on automated decisions, withdrawing consent and complaining to a regulator. - [Why does Clatter Labs ask me to prove who I am for a privacy request?](https://help.clatterlabs.com/security-privacy/your-rights/identity-verification): To make sure we don't give your data to someone else. We only ask for what's needed to verify you. ### Keeping your account and keys safe - [Am I responsible for what happens on my account?](https://help.clatterlabs.com/security-privacy/account-security/am-i-responsible-for-activity-on-my-account): Yes. You're responsible for activity under your account and API keys, unless caused by Clatter Labs breaking the Terms. - [Are cla.wtf links really from Clatter Labs?](https://help.clatterlabs.com/security-privacy/account-security/cla-wtf-links-official): Yes. cla.wtf is Clatter Labs' official short-link domain, managed by Clatter Labs and protected against tampering. - [How do I keep Line CLI and my keys safe on my own computer?](https://help.clatterlabs.com/security-privacy/account-security/using-my-own-device-securely): Lock your device, keep Line updated, store keys outside code, and sign out with line logout on shared machines. - [How do I report a phishing message pretending to be Clatter Labs?](https://help.clatterlabs.com/security-privacy/account-security/report-phishing): Don't click or reply. Forward details to support@clatterlabs.com, and change your password if you entered it anywhere. - [How do I spot a fake Clatter Labs email?](https://help.clatterlabs.com/security-privacy/account-security/spot-a-fake-clatter-email): Account emails are only sign-in codes, magic links, password reset links and new-device alerts. Anything else asking for codes is suspicious. - [I got a notice that a token or key was exposed. What does it mean?](https://help.clatterlabs.com/security-privacy/account-security/token-exposure-notice): We detected that a token may have leaked and revoked or disabled it where we could. Create a new one and check for misuse. - [Is it allowed to jailbreak or get around safety filters?](https://help.clatterlabs.com/security-privacy/account-security/jailbreaking-not-allowed): No. Circumventing safety systems, filters, quotas, metering or authentication, including jailbreaks for prohibited content, breaks the Terms. - [My Clatter Labs account was hacked. What do I do?](https://help.clatterlabs.com/security-privacy/account-security/my-account-was-hacked): Secure your email, sign in with a code, change your password, revoke sessions, apps and keys, turn on 2FA and tell support. - [Security checklist for your Clatter Labs account](https://help.clatterlabs.com/security-privacy/account-security/security-checklist): Ten quick steps: strong sign-in, 2FA, device review, app review, scoped keys, no keys in front-end code, and more. - [What does Clatter Labs do if it thinks my account is compromised?](https://help.clatterlabs.com/security-privacy/account-security/what-clatter-does-if-account-compromised): We may revoke credentials or sessions and temporarily suspend the account to protect it, and tell you where practicable. - [Who is responsible when an AI agent does something I approved?](https://help.clatterlabs.com/security-privacy/account-security/approving-agent-actions): You are. Read what Line CLI or Cosmos Agent asks to do before approving; you're responsible for actions you approve or let run unattended. - [Will Clatter Labs ever ask for my password or sign-in code?](https://help.clatterlabs.com/security-privacy/account-security/will-clatter-ask-for-my-password): No. Staff never need your password, sign-in code, two-factor code or full API key. Never share them. - [Will Clatter Labs tell me if there's a data breach?](https://help.clatterlabs.com/security-privacy/account-security/data-breach-notification): Yes, if a breach is likely to put your rights at high risk. Authorities are notified within 72 hours where required and feasible. ### Abuse policy - [A web page my agent read contained insults. Will I get a strike?](https://help.clatterlabs.com/security-privacy/abuse-policy/website-text-with-insults): No. Only the newest message a person wrote is checked, never tool output such as fetched pages or file contents. - [Can I ask the assistant to help build a profanity filter?](https://help.clatterlabs.com/security-privacy/abuse-policy/building-a-profanity-filter): Yes. Asking about a word, translating it or building a filter for it doesn't count as abuse. - [Do I need to do anything when my 24-hour suspension ends?](https://help.clatterlabs.com/security-privacy/abuse-policy/suspension-ends-automatically): No. Your account works again on its own when the 24 hours end. Don't retry API calls before resets_at. - [Does the abuse policy apply in every language?](https://help.clatterlabs.com/security-privacy/abuse-policy/insulted-in-another-language): The published policy doesn't limit itself to one language: insulting or cursing at the assistant isn't allowed. - [How do I appeal an abuse-policy strike or suspension?](https://help.clatterlabs.com/security-privacy/abuse-policy/appeal-a-strike): Contact Support with your Account ID and the time of the request. If the appeal is accepted, the suspension is lifted early. - [How do I protect my app from abuse-policy suspensions?](https://help.clatterlabs.com/security-privacy/abuse-policy/protect-your-app-from-abuse-strikes): Moderate end-user input before sending it, log the warning header, and block users who trigger it. - [How long does a strike stay on my account?](https://help.clatterlabs.com/security-privacy/abuse-policy/how-long-does-a-strike-last): Strikes are counted within a 30-day window. The suspension itself lasts 24 hours and lifts automatically. - [I pasted logs or code that contain swear words. Is that a strike?](https://help.clatterlabs.com/security-privacy/abuse-policy/pasting-logs-with-swear-words): No. Quoted text such as code, logs, pasted errors, string literals and quotes doesn't count. - [If one team member gets suspended, does the whole team stop?](https://help.clatterlabs.com/security-privacy/abuse-policy/team-member-triggers-suspension): A suspension applies to the account that wrote the messages, or to the key owner's account for API text. Use separate keys and moderation. - [My app sends users' text to the API. Who gets the strike?](https://help.clatterlabs.com/security-privacy/abuse-policy/key-owner-responsible-for-end-users): You do. Text your app sends through your API key counts against your account, exactly as if you wrote it. - [What counts as abuse under the abuse policy?](https://help.clatterlabs.com/security-privacy/abuse-policy/what-counts-as-abuse): Only insults or cursing aimed at the assistant. Swearing at a bug, quoted text, or asking about a word don't count. - [What do the abuse warning headers and suspension error look like?](https://help.clatterlabs.com/security-privacy/abuse-policy/abuse-headers-and-errors): Warnings add x-clatter-notice and x-clatter-notice-text headers. Suspensions return 403 account_suspended with resets_at and Retry-After. - [What happens when I get a warning or a strike?](https://help.clatterlabs.com/security-privacy/abuse-policy/what-happens-on-a-strike): A first strike in 30 days is a warning; your request still works. A second within 30 days pauses the account for 24 hours. - [What is the Clatter Labs abuse policy?](https://help.clatterlabs.com/security-privacy/abuse-policy/what-is-the-abuse-policy): Insulting or cursing at the assistant earns a warning; a second time within 30 days pauses your account for 24 hours on every product. - [What still works during an abuse-policy suspension?](https://help.clatterlabs.com/security-privacy/abuse-policy/suspension-what-still-works): Support stays reachable. Credits, plan, keys and data are untouched; all products resume after 24 hours. - [Which messages does the abuse check look at?](https://help.clatterlabs.com/security-privacy/abuse-policy/what-is-checked): Only the newest message a person wrote. Never tool output, system prompts or the model's own replies. - [Which products does the abuse policy cover?](https://help.clatterlabs.com/security-privacy/abuse-policy/which-products-abuse-policy-covers): Line CLI, the Model API, the Agent API, the Console Playground and Cosmos Agent, including on Telegram. - [Why did the assistant warn me about rude words?](https://help.clatterlabs.com/security-privacy/abuse-policy/abuse-policy-for-kids): Being rude or swearing at the assistant isn't allowed. The first time is a warning; a second time within 30 days pauses your account for a day. - [Will I get a strike for swearing at my code or a bug?](https://help.clatterlabs.com/security-privacy/abuse-policy/does-swearing-at-code-count): No. Frustration aimed at a bug, a build, a tool or a third party doesn't count. Only insults aimed at the assistant do. ### Suspension and termination - [Can I still contact support while my account is suspended?](https://help.clatterlabs.com/security-privacy/suspension/cant-reach-support-while-suspended): Yes. Support stays reachable during suspensions, by the Support Center and email. - [Can my account be limited because a payment failed?](https://help.clatterlabs.com/security-privacy/suspension/suspended-for-non-payment): Yes. If a payment fails, is reversed or charged back, paid features may be suspended until it's paid, and reversed amounts may come off your credits. - [Does Clatter Labs report illegal content to the police?](https://help.clatterlabs.com/security-privacy/suspension/content-reported-to-authorities): Child sexual abuse material is reported to competent authorities. Clatter Labs may also cooperate with law enforcement where legally required. - [How do I appeal a suspension or termination?](https://help.clatterlabs.com/security-privacy/suspension/appeal-a-suspension): Contact support with your Account ID, what happened and why you think it's wrong. Appeals are reviewed in good faith, by a human on request. - [If my account is terminated, can I get my data out?](https://help.clatterlabs.com/security-privacy/suspension/termination-what-happens-to-data): Usually yes: content is available to export for 30 days, unless termination was for a serious breach, legal prohibition or security risk. - [My account was terminated. Can I make a new one?](https://help.clatterlabs.com/security-privacy/suspension/banned-can-i-make-new-account): No, not without Clatter Labs' written permission. Creating accounts to evade bans or suspensions isn't allowed. - [What isn't allowed on Clatter Labs?](https://help.clatterlabs.com/security-privacy/suspension/what-is-not-allowed): Illegal use, malware, attacking systems, child sexual abuse material, weapons, terrorism, fraud, spam, harassment, deepfake deception and more. - [What's the difference between suspension and termination?](https://help.clatterlabs.com/security-privacy/suspension/what-is-termination): Suspension pauses access temporarily. Termination ends your account and the Terms, revokes all API keys and starts deletion. - [Why was my account suspended?](https://help.clatterlabs.com/security-privacy/suspension/why-was-my-account-suspended): Common reasons: a second abuse-policy strike, breaking the acceptable use rules, a security risk or compromise, sanctions or the law. - [Will I be warned before my account is suspended?](https://help.clatterlabs.com/security-privacy/suspension/warning-before-suspension): Under the abuse policy you get a warning first. For other suspensions Clatter Labs notifies you where practicable and lawful, sometimes after acting. ### Responsible disclosure - [Can I run a security scanner against Clatter Labs?](https://help.clatterlabs.com/security-privacy/responsible-disclosure/can-i-scan-clatter-labs): Not without authorisation. Unauthorised scanning or probing is prohibited. Ask for written permission first. - [Does Clatter Labs have a bug bounty?](https://help.clatterlabs.com/security-privacy/responsible-disclosure/bug-bounty): No public bug bounty programme or reward amounts are published. Report issues through the Support Center. - [How do I report a security vulnerability?](https://help.clatterlabs.com/security-privacy/responsible-disclosure/report-a-security-vulnerability): Report it through the Support Center marked as a security report. Keep it confidential, and avoid harm to users and data. - [I found someone's Clatter Labs API key online. What should I do?](https://help.clatterlabs.com/security-privacy/responsible-disclosure/found-leaked-clatter-key): Don't use it. Report where you found it through the Support Center so it can be disabled and the owner told. - [What are the rules for security research on Clatter Labs?](https://help.clatterlabs.com/security-privacy/responsible-disclosure/rules-for-security-research): Only under the responsible-disclosure policy or with written permission, avoiding harm, and reported promptly and confidentially. - [What happens after I report a vulnerability?](https://help.clatterlabs.com/security-privacy/responsible-disclosure/what-happens-after-reporting): Support confirms receipt and the team investigates. We usually reply within the first hour and always within 24 hours. - [What should I include in a vulnerability report?](https://help.clatterlabs.com/security-privacy/responsible-disclosure/what-to-include-in-a-report): The affected product and URL, steps to reproduce, impact, what you accessed, and how to contact you. - [What shouldn't I do while testing for vulnerabilities?](https://help.clatterlabs.com/security-privacy/responsible-disclosure/what-not-to-do-when-testing): Don't access or change others' data, don't disrupt service, don't use denial-of-service, and don't disclose publicly before a fix. ### Privacy Policy and Terms in plain words - [Are beta and early-access features covered by the same rules?](https://help.clatterlabs.com/security-privacy/legal/beta-features-terms): Yes, they're part of the Services, provided "as is", and may change or end. Privacy and acceptable use still apply. - [Can I trust AI answers from Clatter Labs?](https://help.clatterlabs.com/security-privacy/legal/ai-outputs-can-be-wrong): Check them. Outputs can be wrong, outdated or biased, aren't professional advice, and generated code must be reviewed and tested. - [Can I use the Clatter Labs name or logo?](https://help.clatterlabs.com/security-privacy/legal/can-i-use-clatter-logos): Not without permission or published brand guidelines. Names like Clatter, SuperCosmos, Cosmos and Line are Clatter Labs trademarks. - [How do I contact Clatter Labs about a legal matter?](https://help.clatterlabs.com/security-privacy/legal/legal-contact): Use the Support Center and mark the request as legal, takedown, privacy or security. No postal address is published. - [How do I send a copyright takedown request?](https://help.clatterlabs.com/security-privacy/legal/how-to-send-a-takedown-request): Send it through the Support Center marked as a copyright or takedown request, with the details the Terms require. - [How will I know if the Privacy Policy or Terms change?](https://help.clatterlabs.com/security-privacy/legal/how-will-i-know-about-policy-changes): Material changes are announced by email or in-product notice in advance; the Terms give at least 30 days' notice. - [My content was taken down for copyright. How do I respond?](https://help.clatterlabs.com/security-privacy/legal/counter-notice): Send a counter-notice with the required statements. The material may be restored unless the complainant starts legal proceedings. - [What are Clatter Labs' liability limits?](https://help.clatterlabs.com/security-privacy/legal/liability-limits): Generally capped at the greater of what you paid in the last 12 months or USD 100, with exceptions mandatory law requires. - [What do the Terms of Service say, in plain words?](https://help.clatterlabs.com/security-privacy/legal/terms-of-service-summary): A plain-language summary of the Clatter Labs Terms of Service, effective November 1, 2026. The full Terms always control. - [What does the Privacy Policy say, in plain words?](https://help.clatterlabs.com/security-privacy/legal/privacy-policy-summary): A short summary of the Clatter Labs Privacy Policy, effective November 1, 2026. The full policy always controls. - [What happens to feedback or ideas I send Clatter Labs?](https://help.clatterlabs.com/security-privacy/legal/feedback-licence): Clatter Labs may use suggestions, ideas and bug reports freely, without any obligation to you. - [Which law applies, and how are disputes handled?](https://help.clatterlabs.com/security-privacy/legal/governing-law-and-disputes): Egyptian law. Disputes go to 30 days of negotiation, then CRCICA arbitration in Cairo in English. Consumers keep their home-country rights. - [Who is "Clatter Labs Software" in the legal pages?](https://help.clatterlabs.com/security-privacy/legal/who-is-clatter-labs-software): Clatter Labs Software is the company that provides the services, whose founder is based in Egypt. It's the controller of your account data. - [Who owns what the AI creates for me?](https://help.clatterlabs.com/security-privacy/legal/who-owns-ai-outputs): You do. You keep rights in your inputs, and Clatter Labs assigns you its rights in outputs, without promising they're protectable. ### Teens and children - [Can a teenager buy a plan or credits?](https://help.clatterlabs.com/security-privacy/minors/minors-buying-plans): Only through a parent or guardian, or as the law and Gumroad's terms allow. - [Can children under 13 use Clatter Labs?](https://help.clatterlabs.com/security-privacy/minors/children-under-13): No. Accounts for children under 13 aren't allowed and are closed, with their data deleted. - [Can my app send children's data to the Clatter Labs API?](https://help.clatterlabs.com/security-privacy/minors/developers-and-childrens-data): Not data of children under 13 without verifiable parental consent and full COPPA compliance, and not without a lawful basis. - [Can teenagers use Clatter Labs?](https://help.clatterlabs.com/security-privacy/minors/can-teens-use-clatter-labs): Yes, from age 13, with a parent or guardian's consent where the law requires it. In Egypt, under-18s always need it. - [How do I report an account used by a child under 13?](https://help.clatterlabs.com/security-privacy/minors/report-underage-account): Contact Clatter Labs through the privacy contact. Accounts of children under 13 are suspended and their data deleted. - [How does a parent or guardian give consent for a teen?](https://help.clatterlabs.com/security-privacy/minors/parent-consent-how): The parent or guardian agrees to the Terms and Privacy Policy on the teen's behalf and supervises their use. We may ask for evidence. - [How does Clatter Labs protect users under 18?](https://help.clatterlabs.com/security-privacy/minors/how-are-minors-protected): No use of their content for training, no marketing, no selling or sharing, and parents can ask for deletion. - [I'm a parent. How do I get my child's account closed?](https://help.clatterlabs.com/security-privacy/minors/parent-wants-account-deleted): Send a privacy request through the Support Center, or email infrastructure@clatterlabs.xyz. We'll close the account and delete its data. - [I'm a teenager. What are my rights with my data? (simple)](https://help.clatterlabs.com/security-privacy/minors/teen-rights-simple): You can see, download, fix and delete your information, and Clatter Labs won't use your chats to train AI or show you ads. - [Will Clatter Labs ask me to prove my age?](https://help.clatterlabs.com/security-privacy/minors/age-verification): It may. Clatter Labs can ask you to confirm your age, and for evidence of parental consent where the law requires. ### Users in Egypt - [Can I complain to the Personal Data Protection Center in Egypt?](https://help.clatterlabs.com/security-privacy/egypt/egypt-complaint-pdpc): Yes. Egyptian users can complain to the Personal Data Protection Center as well as contacting Clatter Labs. - [Do users in Egypt under 18 need a guardian's consent?](https://help.clatterlabs.com/security-privacy/egypt/egypt-minors-consent): Yes. Under Law No. 151 of 2020, Egyptian users aged 13 to 17 may use Clatter Labs only with a parent or guardian's consent. - [Is data of Egyptian users sent outside Egypt?](https://help.clatterlabs.com/security-privacy/egypt/data-transfers-outside-egypt): Yes. It's processed outside Egypt, including in the EU and the US, only where Law No. 151 of 2020's transfer conditions are met. - [Is there an Arabic version of the Terms, and which one counts?](https://help.clatterlabs.com/security-privacy/egypt/arabic-version-of-terms): The Terms are in English and may be translated. English prevails unless Egyptian or other law requires the Arabic version to prevail. - [What consumer rights do I have in Egypt?](https://help.clatterlabs.com/security-privacy/egypt/egyptian-consumer-rights): Consumers keep their rights under Egyptian Consumer Protection Law No. 181 of 2018 and can complain to the Consumer Protection Agency. - [What data rights do users in Egypt have?](https://help.clatterlabs.com/security-privacy/egypt/egyptian-data-rights): To know about, access and obtain data; withdraw consent; correct, erase or update; restrict; object; and be told about breaches. - [Which Egyptian data protection law applies to Clatter Labs?](https://help.clatterlabs.com/security-privacy/egypt/egypt-data-protection-law): The Personal Data Protection Law No. 151 of 2020 and its executive regulations, as applicable to a software company providing online services. - [Why is Egyptian law the governing law?](https://help.clatterlabs.com/security-privacy/egypt/governing-law-and-disputes-egypt): Clatter Labs Software is established in Egypt, so the Terms and Privacy Policy are governed by Egyptian law, without removing your local mandatory rights. - [Will Egyptian users be told about a data breach?](https://help.clatterlabs.com/security-privacy/egypt/egypt-breach-notification): Yes. Clatter Labs will notify the Personal Data Protection Center and affected individuals within the periods Law No. 151 of 2020 requires. ### Restricted countries and sanctions - [Can I use a VPN to access Clatter Labs from a restricted country?](https://help.clatterlabs.com/security-privacy/restricted-countries/can-i-use-a-vpn): No. Using a VPN, proxy, remote desktop or false location to get around restrictions isn't allowed and can lead to immediate suspension. - [Can I use Clatter Labs while travelling to a restricted country?](https://help.clatterlabs.com/security-privacy/restricted-countries/travelling-to-a-restricted-country): No. The services may not be accessed from restricted jurisdictions, even temporarily, and VPNs to get around that aren't allowed. - [Do export-control laws apply to my use of Clatter Labs outputs?](https://help.clatterlabs.com/security-privacy/restricted-countries/export-controls): Yes. You must comply with export-control and sanctions laws for the services, outputs and software, and not transfer them in breach. - [Do I get a refund if my account is closed because of my country?](https://help.clatterlabs.com/security-privacy/restricted-countries/refund-restricted-country): Where sanctions law doesn't prohibit it, unused purchased credits are refunded and you get at least 14 days to export. - [How does Clatter Labs know which country I'm in?](https://help.clatterlabs.com/security-privacy/restricted-countries/how-location-is-detected): From signals like the country of your IP address, your billing country and information you provide. - [I'm not in a restricted country but Clatter Labs is blocked for me](https://help.clatterlabs.com/security-privacy/restricted-countries/wrongly-blocked): Your IP may look like it's in a restricted location. Turn off VPNs or proxies, try another network, then contact support for review. - [What happens if my account is used from a restricted country?](https://help.clatterlabs.com/security-privacy/restricted-countries/what-happens-if-detected): It may be suspended immediately. Personal data is deleted within 90 days, except what the law requires keeping. You can ask for human review. - [Where isn't Clatter Labs available?](https://help.clatterlabs.com/security-privacy/restricted-countries/where-is-clatter-labs-not-available): Ethiopia, India, Israel and Argentina, plus sanctioned jurisdictions: Cuba, Iran, North Korea, Syria, and the Crimea, Donetsk and Luhansk regions. - [Why is Clatter Labs unavailable in some countries?](https://help.clatterlabs.com/security-privacy/restricted-countries/why-these-countries): Because of sanctions, export-control law, legal risk or business decisions. The list can change. ### Teams, developers and enterprise - [Can my employer see what I do in Clatter Labs?](https://help.clatterlabs.com/security-privacy/teams-enterprise/employee-monitoring): Within the team, yes: the owner sees your usage, access and limits. They can't see your personal account settings, password or 2FA. - [Does Clatter Labs sign a Data Processing Agreement (DPA)?](https://help.clatterlabs.com/security-privacy/teams-enterprise/enterprise-data-processing-agreement): Yes, for enterprise customers: a DPA under GDPR Article 28 with Standard Contractual Clauses, sub-processor notice and audit terms. - [I build apps on Clatter Labs APIs. What are my privacy duties?](https://help.clatterlabs.com/security-privacy/teams-enterprise/developers-data-responsibilities): You're the controller of your users' data: give them a privacy notice, have a lawful basis, and don't send under-13 or special data without safeguards. - [I'm a team member. Who handles my privacy requests about team data?](https://help.clatterlabs.com/security-privacy/teams-enterprise/team-member-privacy-requests): Requests about team data are referred to the team owner, except model-training objections, which Clatter Labs handles itself. - [Is enterprise data used for model training?](https://help.clatterlabs.com/security-privacy/teams-enterprise/enterprise-training-default): It may be, unless a signed DPA or enterprise agreement says otherwise, or the customer objects. - [Is it safe to use Clatter Labs with my company's confidential data?](https://help.clatterlabs.com/security-privacy/teams-enterprise/confidential-company-data): Data is encrypted and access-controlled, but content may train models unless you object or sign a DPA. Keep secrets out of prompts. - [What are a team owner's privacy responsibilities?](https://help.clatterlabs.com/security-privacy/teams-enterprise/team-owner-responsibilities): The organisation is the controller of team data. The owner must tell members how usage, quotas, limits and audit logs are used. - [What does the team audit log record?](https://help.clatterlabs.com/security-privacy/teams-enterprise/audit-log-privacy): Administrative actions such as invitations, role changes and changes to access or limits. The team owner can view it. - [What happens to data when a team is deleted?](https://help.clatterlabs.com/security-privacy/teams-enterprise/team-deleted-what-happens): Content in the team's workspace is deleted under the retention rules. Members' personal accounts aren't deleted. - [Who controls data inside a Console team?](https://help.clatterlabs.com/security-privacy/teams-enterprise/who-controls-team-data): The organisation is the controller and Clatter Labs the processor, except for model training, where Clatter Labs is an independent controller. - [Will Clatter Labs fill in our security questionnaire?](https://help.clatterlabs.com/security-privacy/teams-enterprise/enterprise-security-questionnaires): Yes. On request and under reasonable confidentiality, Clatter Labs provides security descriptions and questionnaire answers. ### Cookies and emails - [Does Clatter Labs honour Do Not Track or Global Privacy Control?](https://help.clatterlabs.com/security-privacy/cookies-communications/global-privacy-control): Global Privacy Control is honoured as an opt-out of sale and sharing. Do Not Track isn't handled separately since there's no cross-site tracking. - [What cookies does Clatter Labs use?](https://help.clatterlabs.com/security-privacy/cookies-communications/what-cookies-do-you-use): Essential cookies only: an HttpOnly session cookie and strictly necessary security cookies. No advertising or tracking cookies. - [What does Clatter Labs store in my browser's local storage?](https://help.clatterlabs.com/security-privacy/cookies-communications/local-storage-use): Essential settings such as interface preferences, like your theme. Not used for tracking. - [What emails will Clatter Labs send me?](https://help.clatterlabs.com/security-privacy/cookies-communications/what-emails-will-i-get): Account emails are sign-in codes, magic links, password resets and new-device alerts. Others: status alerts you subscribe to, and required notices. - [What happens to my email if I subscribe to status alerts?](https://help.clatterlabs.com/security-privacy/cookies-communications/status-email-data): It's used only to send incident and maintenance notices, and every notice has an unsubscribe link. - [Why did I get an email from Clatter Labs when I didn't sign up for news?](https://help.clatterlabs.com/security-privacy/cookies-communications/service-emails-without-consent): Some notices are required to run your account: sign-in codes, security alerts, policy changes, security incidents or a service ending. - [Why don't some Clatter Labs sites show a cookie banner?](https://help.clatterlabs.com/security-privacy/cookies-communications/why-no-cookie-banner): Because they use only essential cookies, which don't need consent. Non-essential cookies would be asked about first. - [Will Clatter Labs send me marketing emails?](https://help.clatterlabs.com/security-privacy/cookies-communications/marketing-emails): Only if you agree. You can withdraw consent with the unsubscribe link in any such message. ## Status & incidents Reading the status page, incidents, maintenance and what to do during an outage. ### Using the status page - [Does Clatter Labs guarantee an uptime percentage (SLA)?](https://help.clatterlabs.com/status/using-status/is-there-an-sla): No uptime SLA is published. The Terms say Clatter Labs uses reasonable efforts but doesn't guarantee uninterrupted service. - [Does the status page show problems with my own account?](https://help.clatterlabs.com/status/using-status/status-shows-my-account): No. It shows service-wide health. Issues with your key, credits, limits or suspension won't appear there. - [How do I know if Clatter Labs is broken right now? (simple)](https://help.clatterlabs.com/status/using-status/status-page-for-kids): Open status.clatterlabs.com. Green "Operational" means it's working. Anything else means there's a problem the team knows about. - [How do I read the 90-day bars on the status page?](https://help.clatterlabs.com/status/using-status/read-the-90-day-bars): Each group shows a bar of the last 90 days. Hover or tap a day for details; "No data" means nothing was recorded that day. - [How do I see the status of one specific service?](https://help.clatterlabs.com/status/using-status/component-pages): Click any component on the status page to open its own page with its history. - [The status page itself won't load](https://help.clatterlabs.com/status/using-status/status-page-down): Try again, another network or browser, or the RSS feed. If everything is down, contact support by email. - [What do Operational, Degraded, Partial outage and Major outage mean?](https://help.clatterlabs.com/status/using-status/what-do-status-colors-mean): Operational is working normally; Degraded is slower; Partial outage means some features are down; Major outage means the service is unavailable. - [What does "No active incidents" mean?](https://help.clatterlabs.com/status/using-status/no-active-incidents): No incident is currently posted for any Clatter Labs service. If something's still wrong for you, check your setup or contact support. - [What does the "Updated" time at the top of the status page mean?](https://help.clatterlabs.com/status/using-status/last-updated-time): It's when the page's data was last refreshed. Reload to get the newest status. - [What is the Clatter Labs status page?](https://help.clatterlabs.com/status/using-status/what-is-the-status-page): status.clatterlabs.com shows the live health of every Clatter Labs service, current incidents, history and planned maintenance. - [What time zone does the status page use?](https://help.clatterlabs.com/status/using-status/status-page-time-zone): The status page shows times in GMT+0 (UTC). Convert to your local time when reading incidents. - [Where can I see past uptime and incidents?](https://help.clatterlabs.com/status/using-status/uptime-history): Open History at status.clatterlabs.com/history for archived incidents and uptime, useful for audits and reliability reviews. ### Services and components - [What do the "Services" rows (website, Ask AI, Docs, Support) cover?](https://help.clatterlabs.com/status/components/services-components): The clatterlabs.com website, the website's Ask AI assistant, the developer docs, and the Support Center. - [What do the Accounts components on the status page cover?](https://help.clatterlabs.com/status/components/accounts-components): Account center, Sign-in, App sign-in, Social sign-in (GitHub, Vercel, Hugging Face), Email delivery, Identity service and cla.wtf links. - [What do the Agent API components on the status page cover?](https://help.clatterlabs.com/status/components/agent-api-components): Agent API (api.agent.clatterlabs.xyz), Runs (create, stream, cancel), Agent configuration, Cosmos Agent APIs and the Cosmos Agent backend. - [What do the Code Buckets components on the status page cover?](https://help.clatterlabs.com/status/components/code-buckets-components): Code Buckets API (api.codebuckets.clatterlabs.xyz), Storage (buckets, uploads, backups) and the Public files CDN. - [What do the Console components on the status page cover?](https://help.clatterlabs.com/status/components/console-components): Console is the console.clatterlabs.com web app; Console API covers keys, usage and billing behind it. - [What do the Line CLI components on the status page cover?](https://help.clatterlabs.com/status/components/line-cli-components): Line API (chat, delegation, sign-in), Model catalogue, the macOS/Linux and Windows installers, and the Updates manifest. - [What do the Model API and Models rows on the status page mean?](https://help.clatterlabs.com/status/components/model-api-components): Model API covers api.gateway.clatterlabs.xyz/v1. Models show SuperCosmos 1.1 Flash, Max and Heavy separately. - [What do the Payments components on the status page cover?](https://help.clatterlabs.com/status/components/payments-components): Checkout covers buying plans and credit packs (via Gumroad); Billing covers plans, credits and rates in the Console. - [Which services does the status page track?](https://help.clatterlabs.com/status/components/what-services-are-tracked): Agent API, Model API, SuperCosmos models, Line CLI, Code Buckets, Console, Payments, Accounts, and the website, docs, Ask AI and Support. - [Why aren't Clatter Editor, Community or Line Code on the status page?](https://help.clatterlabs.com/status/components/retired-products-not-listed): They're retired, so there's nothing to monitor. Clatter Editor and Community show closure notices, and Line Code ids return 410. - [Why does the status page say SuperCosmos 1.1 instead of 1.0?](https://help.clatterlabs.com/status/components/supercosmos-1-1-rows): SuperCosmos 1.1 became the model behind every Clatter Labs product on November 2, 2026, so the model rows show 1.1. - [Why is cla.wtf on the status page?](https://help.clatterlabs.com/status/components/what-is-cla-wtf-component): cla.wtf is Clatter Labs' official short-link domain; if it's down, short links in docs and messages may not redirect. ### Incidents and maintenance - [Do I get credits or refunds for downtime?](https://help.clatterlabs.com/status/incidents/incident-credits): No automatic downtime credits are published. The Terms don't guarantee uninterrupted service; contact support if an incident cost you money. - [Does Clatter Labs announce maintenance in advance?](https://help.clatterlabs.com/status/incidents/planned-maintenance): Yes. Maintenance notices are posted on the status page in advance so you can plan around them. - [How are incidents reported on the status page?](https://help.clatterlabs.com/status/incidents/how-incidents-are-reported): Active incidents appear at the top with investigation steps, causes and progress until resolved, then move to History. - [Something is clearly down but there's no incident yet. Why?](https://help.clatterlabs.com/status/incidents/incident-not-posted-yet): The team may still be confirming it. Report it to support with details, and check again shortly. - [What happens during an incident, from start to finish?](https://help.clatterlabs.com/status/incidents/incident-stages): An incident is created, updated as the team investigates and fixes it, then marked resolved. Subscribers are emailed at each step. - [What should I do during an incident?](https://help.clatterlabs.com/status/incidents/what-to-do-during-an-incident): Follow the incident updates, retry with backoff, avoid tight retry loops, and switch effort or wait if a model is affected. - [Why do incidents happen?](https://help.clatterlabs.com/status/incidents/incident-causes): Software bugs, capacity limits, maintenance, or outages at third-party infrastructure providers can all cause incidents. - [Will I get an explanation after an incident?](https://help.clatterlabs.com/status/incidents/incident-report-after): Incident posts include causes and progress to resolution, and they stay in History for later review. ### Status notifications - [Can I get Clatter Labs status updates in my team chat?](https://help.clatterlabs.com/status/notifications/status-in-slack-or-chat): Use the RSS feed with your chat tool's RSS integration. There's no separate webhook published. - [How can my company monitor Clatter Labs status automatically?](https://help.clatterlabs.com/status/notifications/monitor-status-automatically): Follow the RSS feed in your monitoring tools, subscribe a shared mailbox, and watch API error codes in your own logs. - [How do I get emails when there's an incident?](https://help.clatterlabs.com/status/notifications/subscribe-to-status-emails): On status.clatterlabs.com choose Subscribe and enter your email. You'll be alerted when incidents are created, updated or resolved. - [How do I stop status emails?](https://help.clatterlabs.com/status/notifications/unsubscribe-from-status-emails): Use the unsubscribe link at the bottom of any status notice. - [I subscribed but I'm not getting status emails](https://help.clatterlabs.com/status/notifications/not-getting-status-emails): Emails only go out when incidents are created, updated or resolved. Check spam and confirm the address you subscribed. - [Is there an RSS feed for Clatter Labs status?](https://help.clatterlabs.com/status/notifications/status-rss-feed): Yes: https://status.clatterlabs.com/rss.xml. Point a feed reader or an integration at it. ### When something seems down - [A public Code Buckets file link isn't loading. Is the CDN down?](https://help.clatterlabs.com/status/troubleshooting/public-file-not-loading): Check the Public files CDN component. If it's Operational, confirm the file is still public and the link is correct. - [How do I report an outage that isn't on the status page?](https://help.clatterlabs.com/status/troubleshooting/report-an-outage): Contact the Support Center or email support with the time (with time zone), service, error codes and request IDs. - [I can't buy a plan or credits. Is checkout down?](https://help.clatterlabs.com/status/troubleshooting/cant-buy-plan-during-incident): Check the Payments components (Checkout and Billing). If there's an incident, wait before retrying to avoid duplicate charges. - [I can't sign in and there's an Accounts incident. What now?](https://help.clatterlabs.com/status/troubleshooting/cant-sign-in-during-incident): Wait for the incident to resolve; there's nothing to fix on your side. API keys don't need sign-in and may keep working. - [Is Clatter Labs down, or is it just me?](https://help.clatterlabs.com/status/troubleshooting/is-it-down-or-just-me): Check status.clatterlabs.com first. If everything is Operational, check your network, key and Account ID, then contact support. - [My Cosmos Agent API runs keep failing. Is it an outage?](https://help.clatterlabs.com/status/troubleshooting/agent-runs-failing): Check the Agent API and Runs components. If they're Operational, check the run's error code, credits and the 5 concurrent runs limit. - [Responses are slow. Is something wrong?](https://help.clatterlabs.com/status/troubleshooting/slow-responses): Check for Degraded performance on the model and API rows. If all are Operational, long prompts or the Heavy effort can be slower by design. - [The Line CLI installer or update isn't working. Is it down?](https://help.clatterlabs.com/status/troubleshooting/line-install-failing): Check the Installer and Updates components on the status page, then retry. If they're Operational, check your network and permissions. - [The status page says Operational, but it's broken for me](https://help.clatterlabs.com/status/troubleshooting/status-says-operational-but-broken): Check your network, your API key and your Account ID header, then the error code. Contact support if it continues. - [Which errors usually mean a Clatter Labs outage?](https://help.clatterlabs.com/status/troubleshooting/errors-during-outage): 502 upstream and 503 unavailable usually point to a service problem. 401, 402, 403 and most 429s are about your request or account. ## Developer docs Finding your way around the developer documentation. ### Getting around the docs - [An old docs link takes me to the wrong page or a 404](https://help.clatterlabs.com/docs/getting-around/old-docs-links): Docs moved to developers.clatterlabs.com and some pages changed. Search for the topic, or check the Changelog. - [Are the docs available in other languages?](https://help.clatterlabs.com/docs/getting-around/docs-language): The docs are in English, the only language of Clatter Labs services. - [Can I read the docs on my phone?](https://help.clatterlabs.com/docs/getting-around/phone-layout): Yes. The docs have a phone layout with a menu drawer for the sidebar. - [How do I link to a specific section of a docs page?](https://help.clatterlabs.com/docs/getting-around/link-to-a-section): Use the section's anchor from On this page, or copy the heading link. The URL ends with #section-name. - [How do I move around inside a docs page?](https://help.clatterlabs.com/docs/getting-around/sidebar-and-on-this-page): Use the grouped sidebar to switch pages and the On this page rail to jump between sections. Headings have anchor links. - [How do I switch the docs to dark mode?](https://help.clatterlabs.com/docs/getting-around/dark-mode-in-docs): Use the theme toggle on the docs; light and dark themes are both supported. - [I don't code. Are the docs for me?](https://help.clatterlabs.com/docs/getting-around/docs-for-beginners): The docs are written for developers. If you're not technical, start with this Help Center and the Support Center's Ask AI. - [I'm new. Where should I start in the docs?](https://help.clatterlabs.com/docs/getting-around/start-here): Read the Introduction, then the Quickstart: create a key and run your first Cosmos Agent task in about five minutes. - [What are the tabs at the top of the docs?](https://help.clatterlabs.com/docs/getting-around/docs-tabs): Documentation (guides), API reference (endpoints), Models (SuperCosmos and Line Code) and Changelog (releases), plus a Console button. - [What do the Clatter Labs developer docs cover?](https://help.clatterlabs.com/docs/getting-around/what-do-the-docs-cover): The Cosmos Agent API, Line CLI, Model API, Code Buckets, SuperCosmos models, Console and API keys, billing, plus status, support and policies. - [What does the Console button in the docs do?](https://help.clatterlabs.com/docs/getting-around/console-button): It opens console.clatterlabs.com, where you create API keys and see usage, logs, plan and credits. - [What's on the Core concepts page?](https://help.clatterlabs.com/docs/getting-around/core-concepts-page): The few ideas behind the Agent API and Line CLI: Account ID, runs, the cloud computer, SuperCosmos tiers, credits, and API keys. - [What's the difference between the developer docs and this Help Center?](https://help.clatterlabs.com/docs/getting-around/docs-vs-help-center): The docs are technical guides and API reference for building. The Help Center answers everyday questions about accounts, privacy, billing and problems. ### Searching the docs - [Docs search finds nothing for my question](https://help.clatterlabs.com/docs/search/search-no-results): Try a shorter keyword, an error code, or remove filters. If it's not in the docs, try the Help Center or Support Center. - [How do I search the docs?](https://help.clatterlabs.com/docs/search/open-docs-search): Press ⌘K on Mac or Ctrl+K on Windows and Linux, or click Search. Filter by Documentation, API reference, Models or Changelog. - [Is there an AI assistant in the docs?](https://help.clatterlabs.com/docs/search/is-there-ask-ai-in-docs): Use search to find pages, or the Support Center's Ask AI for questions. You can also give llms-full.txt to your own AI tool. - [Tips for finding things in the docs](https://help.clatterlabs.com/docs/search/search-tips): Search by error code, header or endpoint name; filter by section; and check the Changelog for recent changes. - [What are the filters in docs search?](https://help.clatterlabs.com/docs/search/search-filters): Documentation, API reference, Models and Changelog. Use them to narrow results to guides, endpoints, model pages or release notes. - [What keyboard shortcuts work in docs search?](https://help.clatterlabs.com/docs/search/keyboard-in-search): ⌘K or Ctrl+K opens search; ↑ and ↓ move between results; Enter opens one; Esc closes the dialog. ### Markdown and AI tools - [Can I read the docs offline?](https://help.clatterlabs.com/docs/markdown-and-ai/offline-docs): Download llms-full.txt, which contains every page as Markdown, and open it in any editor. - [How do I get a docs page as Markdown?](https://help.clatterlabs.com/docs/markdown-and-ai/view-page-as-markdown): Use View as Markdown on the page, or add .md to the page URL, for example /quickstart.md. - [How do I use the docs with my AI coding assistant?](https://help.clatterlabs.com/docs/markdown-and-ai/use-docs-with-ai-tools): Point the tool at llms.txt or llms-full.txt, or paste a page via Copy page or its .md URL. - [What does "Copy page" do?](https://help.clatterlabs.com/docs/markdown-and-ai/copy-page-button): It copies the whole page as Markdown to your clipboard, ready to paste into notes, an issue or an AI tool. - [What is llms-full.txt?](https://help.clatterlabs.com/docs/markdown-and-ai/what-is-llms-full-txt): The whole docs site in one Markdown file, in navigation order. Useful for AI tools and offline search. - [What is llms.txt?](https://help.clatterlabs.com/docs/markdown-and-ai/what-is-llms-txt): An index of every docs page with a one-line summary and a link to its Markdown, made for AI tools. ### Using the API reference - [An AI tool gave me an API URL that isn't in the docs](https://help.clatterlabs.com/docs/api-reference/ai-example-urls-wrong): Trust the docs. Use only the published hosts: api.agent.clatterlabs.xyz, api.gateway.clatterlabs.xyz/v1 and api.codebuckets.clatterlabs.xyz. - [Does Try it use my real credits?](https://help.clatterlabs.com/docs/api-reference/try-it-uses-real-credits): Yes. Try it sends real requests to the live API with your key, so metered calls cost credits like any other call. - [How do I use the Try it playground in the API reference?](https://help.clatterlabs.com/docs/api-reference/try-it-playground): Open an endpoint page, enter your key and Account ID, fill parameters and send a real request. Use a test key with limited permissions. - [Is it safe to paste my API key into Try it?](https://help.clatterlabs.com/docs/api-reference/try-it-and-key-safety): Try it runs in your browser against the real API. Use a short-lived, limited key, and never put keys in your own front-end code. - [What are the base URLs for the Clatter Labs APIs?](https://help.clatterlabs.com/docs/api-reference/api-hosts): Agent API https://api.agent.clatterlabs.xyz, Model API https://api.gateway.clatterlabs.xyz/v1, Code Buckets API https://api.codebuckets.clatterlabs.xyz. - [What's in the API reference?](https://help.clatterlabs.com/docs/api-reference/what-is-in-api-reference): Every endpoint of the Agent API, Model API and Code Buckets API, with parameters, examples, errors and a Try it playground. - [Where do I find what an API error code means?](https://help.clatterlabs.com/docs/api-reference/error-tables): Each API has an Errors page, and endpoint pages list their own error tables. The Agent Errors guide explains what to do. - [Which languages are the code samples in?](https://help.clatterlabs.com/docs/api-reference/code-samples-languages): Endpoint pages show cURL, Python and JavaScript examples. The Model API also works with OpenAI-compatible SDKs. ### Changelog and updates - [Can I follow the docs changelog by RSS?](https://help.clatterlabs.com/docs/changelog/changelog-rss): Yes. The docs footer links an RSS feed at developers.clatterlabs.com/rss.xml. - [How do I read a changelog entry?](https://help.clatterlabs.com/docs/changelog/read-a-changelog-entry): Each entry shows the date, product tags, a title, bullet points of changes, and links to the affected docs pages. - [The changelog shows different prices from the docs. Which is right?](https://help.clatterlabs.com/docs/changelog/old-prices-in-changelog): The current docs pages are right. Older changelog entries record prices at the time and may be outdated. - [What were the latest big changes in the docs changelog?](https://help.clatterlabs.com/docs/changelog/what-changed-recently): November 2, 2026: SuperCosmos 1.1 behind every product, Line Code retired, Line CLI 0.9.0-beta, and the abuse policy. - [Where can I see what's new in Clatter Labs products?](https://help.clatterlabs.com/docs/changelog/where-to-see-whats-new): The Changelog tab in the docs lists dated releases with product tags. There's also an RSS feed. ### Feedback and problems - [Can I request a new docs page or example?](https://help.clatterlabs.com/docs/feedback/request-new-docs): Yes. Send the request to support with what you're trying to build and which example would help. - [How do I report a mistake in the docs?](https://help.clatterlabs.com/docs/feedback/report-a-docs-problem): Use Was this page helpful? on the page, and send details to support with the page URL and what's wrong. - [The developer docs won't load](https://help.clatterlabs.com/docs/feedback/docs-site-down): Check the Docs component on the status page. Meanwhile, llms-full.txt or a saved copy may still be available. - [The docs don't answer my question. What now?](https://help.clatterlabs.com/docs/feedback/docs-question-not-answered): Search this Help Center, then ask the Support Center's Ask AI. A human takes over complex technical questions. - [What does "Was this page helpful?" do?](https://help.clatterlabs.com/docs/feedback/was-this-helpful): It sends quick Yes or No feedback about the page to the docs team so unclear pages can be improved. ## Clatter Editor (retired) Clatter Editor has been retired. How to get your files back from your browser. ### Clatter Editor retirement - [Does the Editor shutdown affect my Clatter Labs account?](https://help.clatterlabs.com/editor/retirement/what-happens-to-my-account): No. Your Clatter Labs account, credits, plan and every other product keep working after Clatter Editor went offline. - [I used Clatter Editor. Is anything on my bill affected?](https://help.clatterlabs.com/editor/retirement/did-i-pay-for-editor): Your plan and credits are managed in the Console and are not changed by the Editor going offline. Check Billing to see exactly what you pay for. - [Is Clatter Editor gone?](https://help.clatterlabs.com/editor/retirement/is-clatter-editor-gone): Clatter Editor went offline on November 2, 2026 and will stay unavailable for at least two years. Your account and other products still work. - [The docs still have a Cloud IDE page. Does Cloud IDE still work?](https://help.clatterlabs.com/editor/retirement/cloud-ide-docs-page): Cloud IDE is the same product as Clatter Editor at editor.clatterlabs.com, and it is offline. The docs page stays for reference only. - [Will Clatter Editor ever come back?](https://help.clatterlabs.com/editor/retirement/will-clatter-editor-come-back): Clatter Editor will stay offline for at least two years. There is no replacement editor announced. ### Getting your files back - [Did I push my Editor project to GitHub, GitLab or Bitbucket?](https://help.clatterlabs.com/editor/recover-files/check-git-provider-copy): If you pushed a project from Clatter Editor to GitHub, GitLab or Bitbucket, that copy is in your own repository and is not affected. - [How do I get my Editor files out of my browser?](https://help.clatterlabs.com/editor/recover-files/get-files-out-of-browser): Your Editor files sit in the browser's local storage for editor.clatterlabs.com. Use the same browser and device, then ask support to guide you. - [I cleared my browser data. Can I still get my Editor projects?](https://help.clatterlabs.com/editor/recover-files/cleared-browser-data): If you cleared site data for editor.clatterlabs.com or used a private window, the projects are gone, because no copy existed on Clatter Labs servers. - [I'm on a new computer and can't find my Editor projects](https://help.clatterlabs.com/editor/recover-files/new-device-no-projects): Editor projects were stored in the browser on the device you used them on. A new computer won't have them; go back to the old device. - [Where are my Clatter Editor projects?](https://help.clatterlabs.com/editor/recover-files/where-are-my-editor-projects): Clatter Editor saved projects in your own browser, not on Clatter Labs servers. They are probably still in the browser you used.