API Overview - Bloom Documentation

Base URL

All Bloom API requests are made to:

https://iam.bloomtechnologies.app

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

Check API status:

GET /health

Response:

{
  "status": "healthy",
  "version": "1.0.0",
  "timestamp": "2025-01-15T10:30:00Z"
}

Direct HTTP calls to proxy endpoints