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

# API Reference

> The MINDBLIX REST API provides programmatic access to all platform features. Manage agents, workflows, and integrations through simple HTTP requests.

## Base URL

```
https://api.mindblix.com/v1
```

For self-hosted deployments:

```
http://localhost:8000/api/v1
```

***

## Authentication

All API requests require a Bearer token:

```bash theme={null}
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.mindblix.com/v1/agents
```

> [!NOTE]
>
> Get your API key from the [Dashboard](https://mindblix.com/dashboard/settings/api-keys). Keep it secure and never expose it in client-side code.

***

## Request Format

* Content-Type: `application/json`
* All request bodies should be valid JSON
* Date fields use ISO 8601 format

***

## Response Format

All responses follow a consistent structure:

```json theme={null}
{
  "success": true,
  "data": { ... },
  "metadata": {
    "request_id": "req_abc123",
    "timestamp": "2026-03-04T10:00:00Z",
    "latency_ms": 142
  }
}
```

### Error Responses

```json theme={null}
{
  "success": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "The 'name' field is required",
    "details": { ... }
  }
}
```

***

## HTTP Status Codes

| Code | Meaning |
| - | - |
| `200` | Success |
| `201` | Created |
| `400` | Bad Request — Invalid parameters |
| `401` | Unauthorized — Invalid or missing API key |
| `403` | Forbidden — Insufficient permissions |
| `404` | Not Found — Resource doesn't exist |
| `429` | Rate Limited — Too many requests |
| `500` | Internal Error — Something went wrong on our end |

***

## Rate Limits

| Plan | Requests/min | Requests/day |
| - | - | - |
| Free | 60 | 1,000 |
| Pro | 300 | 10,000 |
| Enterprise | Custom | Custom |

> [!WARNING]
>
> When rate limited, the response includes a `Retry-After` header indicating when you can retry.

***

## Quick Links

> **[Authentication](https://docs.mindblix.tech/api-reference/authentication.md)**
>
> API key management and OAuth setup

> **[Agents API](https://docs.mindblix.tech/api-reference/agents.md)**
>
> Create, configure, and execute agents

> **[Workflows API](https://docs.mindblix.tech/api-reference/workflows.md)**
>
> Build and manage agent workflows

> **[Webhooks](https://docs.mindblix.tech/api-reference/webhooks.md)**
>
> Real-time event notifications


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