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

# API Overview

> Overview of Bloom API endpoints and capabilities

## Base URL

All Bloom API requests are made to:

```
https://iam.bloomtechnologies.app
```

## Error Codes

| Status Code | Meaning           | Common Causes                           |
| ----------- | ----------------- | --------------------------------------- |
| `400`       | Bad Request       | Missing agent\_id or invalid parameters |
| `401`       | Unauthorized      | Invalid or missing API key              |
| `403`       | Forbidden         | Agent lacks required scopes             |
| `404`       | Not Found         | Integration or endpoint doesn't exist   |
| `429`       | Too Many Requests | Rate limit exceeded                     |
| `500`       | Internal Error    | Bloom system error                      |
| `502`       | Bad Gateway       | External service unavailable            |

## Health Check

Check API status:

```http theme={null}
GET /health
```

Response:

```json theme={null}
{
  "status": "healthy",
  "version": "1.0.0",
  "timestamp": "2025-01-15T10:30:00Z"
}
```

## SDKs and Libraries

<CardGroup cols={2}>
  <Card title="MCP Wrapper" icon="puzzle-piece">
    [bloom-mcp-wrapper](https://npmjs.com/package/bloom-mcp-wrapper) for MCP servers
  </Card>

  <Card title="REST API" icon="globe">
    Direct HTTP calls to proxy endpoints
  </Card>
</CardGroup>