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

# API Reference

> Integrate Hiveku into your workflows with the REST API

## Base URL

All API requests are made to:

```
https://app.hiveku.com/api
```

## Authentication

All API endpoints require authentication via Clerk session tokens. See the [Authentication](/api-reference/authentication) page for details.

## Response Format

All responses are JSON. Successful responses return the data directly:

```json theme={null}
{
  "id": "project_abc123",
  "name": "My Project",
  "status": "active"
}
```

Error responses include an error message:

```json theme={null}
{
  "error": "Project not found"
}
```

## HTTP Status Codes

| Code  | Description                            |
| ----- | -------------------------------------- |
| `200` | Success                                |
| `201` | Created                                |
| `400` | Bad request — check your parameters    |
| `401` | Unauthorized — missing or invalid auth |
| `403` | Forbidden — insufficient permissions   |
| `404` | Not found                              |
| `500` | Internal server error                  |

## Rate Limiting

API requests are rate-limited per account. Current limits:

* **100 requests per minute** for standard endpoints
* **10 requests per minute** for AI/generation endpoints

Rate limit headers are included in every response:

```
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1234567890
```

## API Sections

<CardGroup cols={2}>
  <Card title="Builder API" icon="hammer" href="/api-reference/builder-projects">
    Projects, files, AI chat, and deployment
  </Card>

  <Card title="Marketing API" icon="megaphone" href="/api-reference/marketing-content">
    Content, social media, and outbound email
  </Card>

  <Card title="CRM API" icon="address-book" href="/api-reference/crm-contacts">
    Contacts and pipeline management
  </Card>

  <Card title="Authentication" icon="lock" href="/api-reference/authentication">
    How to authenticate API requests
  </Card>
</CardGroup>