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

# Fliqr AI Platform Limits, Quotas, and Rate Limits Guide

> Reference guide for API rate limits, contact caps, flow builder constraints, AI agent limits, and file upload sizes across Fliqr AI plans.

Fliqr AI enforces limits across several dimensions to maintain platform performance and reliability for all customers. This page documents those limits so you can design your integrations and flows within them. Most limits are per-account unless otherwise noted.

If you are approaching a limit and need a higher quota, contact Fliqr AI support to discuss custom allocations.

## API Rate Limits

<Accordion title="REST API">
  | Limit                    | Value                                |
  | ------------------------ | ------------------------------------ |
  | Standard rate limit      | 100 requests per minute per API key  |
  | Burst allowance          | 200 requests in any 10-second window |
  | Rate limit response code | `429 Too Many Requests`              |

  When you exceed the rate limit, the API returns a `429` response with a `Retry-After` header indicating how many seconds to wait before retrying. Implement exponential backoff in any integration that makes frequent API calls.

  Each API key has its own independent rate limit. If you have multiple integrations, consider using separate API keys to avoid one integration consuming the allowance of another.
</Accordion>

## Contacts

<Accordion title="Contact storage limits">
  | Plan | Contact limit                |
  | ---- | ---------------------------- |
  | Pro  | 100,000 contacts per account |

  Contact limits apply to the total number of contact records in your account, regardless of activity status. If you're approaching your contact limit, review and delete contacts that are no longer needed, or contact support to discuss a quota increase.
</Accordion>

## Broadcasts

<Accordion title="Broadcast limits by channel">
  **WhatsApp**

  All WhatsApp broadcasts must use pre-approved message templates. There is no Fliqr AI-side daily limit, but Meta enforces quality-based limits on your WhatsApp Business account:

  * New numbers start with a limit of 1,000 business-initiated conversations per 24-hour period.
  * This limit scales automatically based on message quality and volume over time (up to unlimited).

  **Telegram**

  No broadcast limit is enforced by Fliqr AI or Telegram for standard use. Telegram's spam detection may throttle accounts that send mass messages to contacts who did not initiate the conversation.

  **SMS**

  No Fliqr AI-side daily limit. Volume limits depend on your Twilio number type and registration:

  * Long code (10DLC): Up to 2,400 segments per minute after carrier registration.
  * Short code: Higher throughput; requires carrier approval.

  Note: Carrier filtering applies to all SMS broadcasts. Contacts must have a documented opt-in.
</Accordion>

## Flow Builder

<Accordion title="Flow and block limits">
  | Limit                          | Value |
  | ------------------------------ | ----- |
  | Blocks per flow                | 250   |
  | Flows per account              | 100   |
  | Conditions per condition block | 20    |

  If a complex flow is approaching the 250-block limit, consider splitting it into a parent flow that calls sub-flows using the "Go to Flow" block. This keeps individual flows manageable and the logic modular.
</Accordion>

## AI Agents

<Accordion title="AI Agent limits">
  | Limit               | Value                                         |
  | ------------------- | --------------------------------------------- |
  | Context window      | Determined by the model (GPT-4o: 128k tokens) |
  | Knowledge base size | 500MB of indexed content per agent            |
  | Agents per account  | No hard limit                                 |

  The 500MB knowledge base limit applies per individual AI Agent. If your knowledge base exceeds this, split content across multiple agents and use routing logic to direct contacts to the appropriate agent based on their question category.

  Context window limits are set by the AI model provider. Long conversation histories may exceed the context window — Fliqr AI automatically truncates older messages when this occurs to maintain function.
</Accordion>

## File Uploads

<Accordion title="File upload limits">
  | Limit                    | Value                                             |
  | ------------------------ | ------------------------------------------------- |
  | Max file size per upload | 25MB                                              |
  | Supported file types     | Varies by block type — images, PDFs, audio, video |

  This limit applies to files uploaded within the Flow Builder (e.g., attachments in a Send Message block). For larger files, host them externally and reference the URL in your flow instead of uploading directly.
</Accordion>

## Message History

<Accordion title="Message retention">
  | Data                  | Retention period |
  | --------------------- | ---------------- |
  | Conversation messages | 12 months        |
  | Delivery logs         | 90 days          |
  | Call recordings       | 30 days          |

  Messages older than 12 months are deleted automatically. If you need long-term message archiving, export conversation data via the API or set up a webhook to stream new messages to your own data store in real time.
</Accordion>

<Note>
  If you need a higher quota for any of the limits above, contact Fliqr AI support with your use case. Custom quotas may be available for Pro accounts.
</Note>

## What's Next

<CardGroup cols={2}>
  <Card title="Channel Errors" href="/docs/troubleshooting/channel-errors">
    Diagnose and fix delivery and connection errors on each messaging channel.
  </Card>

  <Card title="FAQ" href="/docs/troubleshooting/faq">
    Answers to common setup and usage questions.
  </Card>
</CardGroup>