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

# Introduction

Welcome to the AI Squared API documentation! You can use our API to access all the features of the AI Squared platform.

## Authentication

The AI Squared API uses a JWT-based authentication mechanism. To access the API, you need a valid JWT token which should be included in the header of your requests. This ensures that your interactions with the API are secure and authenticated.

```text theme={null}
--header 'Authorization: Bearer <YOUR_JWT_TOKEN>'
```

<Warning>
  It is advised to keep your JWT token safe and not share it with anyone. If you
  think your token has been compromised, you can generate a new token from the
  AI Squared dashboard.
</Warning>

## API Endpoints

The AI Squared API is organized around REST. Our API has predictable resource-oriented URLs, accepts JSON-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

### Base URL

The base URL for all API requests is `https://api.squared.ai/api/v1/`

### API Reference

The API reference contains a list of all the endpoints available in the AI Squared API. You can also use the navigation bar on the left to browse through the different endpoints.

<CardGroup cols={2}>
  <Card title="Models" icon="square-1">
    Models are the core of the AI Squared API. They represent the different
    entities in the AI Squared platform.
  </Card>

  <Card title="Connectors" icon="square-2">
    Connectors help connect various data warehouse sources or destinations to
    the AI Squared platform.
  </Card>

  <Card title="Syncs" icon="square-3">
    Syncs help you sync data between different data warehouse sources and
    destinations.
  </Card>

  <Card title="AI Workflows" icon="square-4">
    AI Workflows allow you to build powerful workflows for Agents to trigger.
  </Card>
</CardGroup>

## Pagination

Requests that return multiple items will be paginated to 100 items by default. You can specify further pages with the `page` parameter. You can also set a custom page size up to 100 with the `page_size` parameter.

```text theme={null}
https://api.squared.ai/api/v1/models?page=2&page_size=50
```

## Rate Limiting

The AI Squared API is rate limited to 100 requests per minute. If you exceed this limit, you will receive a `429 Too Many Requests` response.

## Errors

The AI Squared API uses conventional HTTP response codes to indicate the success or failure of an API request. In general, codes in the `2xx` range indicate success, codes in the `4xx` range indicate an error that failed given the information provided, and codes in the `5xx` range indicate an error with AI Squared's servers.
