Public Data Gateway · v1 · Read-only
The Brios Public API provides read-only access to platform data. All endpoints require a valid API key issued by a Super Admin.
Authentication
All public data endpoints require an API key passed as a header:
GET https://api.briosbos.ai/api/v1/public/data?resource=jobs x-api-key: brios_your_api_key_here
• If the API key is missing or invalid → 401 Unauthorized
• If the API key is revoked → 401 Unauthorized (with a specific message)
• Successful requests increment the key's success counter; failed ones increment the failed counter
Autonomous Agent & LLM Tool Calling Compatibility
BRIOS AI READYThe BRIOS Public Data Gateway is engineered for direct function-calling by autonomous AI agents, LangChain pipelines, and intelligent automated workflows.
# BRIOS Standard Tool Definition
{
"type": "function",
"function": {
"name": "brios_fetch_public_data",
"description": "Fetch real-time data from the BRIOS platform for users, jobs, organisations, employees, ebooks, or social_posts",
"parameters": {
"type": "object",
"properties": {
"resource": {
"type": "string",
"enum": ["users", "jobs", "organisations", "employees", "ebooks", "social_posts"]
}
},
"required": ["resource"]
}
}
}Base Endpoint: https://api.briosbos.ai/api/v1/public/data • Always authenticated using your verified BRIOS platform API Key.
Error Responses
| Status | Reason | Message |
|---|---|---|
401 | Missing or invalid API key | Invalid API key |
401 | Key has been revoked | This API key has been revoked |
404 | Unknown resource value | Unknown resource: <value> |
500 | Internal server error | Internal server error |