REST API

Backend API for the GL AIP (GDP Labs AI Agents Package) covering agents, tools, MCP connections, language models, accounts, and utilities. The canonical OpenAPI document is published at https://aip.gdplabs.id/docs and is updated alongside every GL AIP package release.

Base URLs

Environment	Base URL	Notes
Production	https://aip.gdplabs.id	Use issued API key.
Local development	http://localhost:8000	Default FastAPI port.

All paths documented below are relative to the chosen base URL.

Authentication

Unless noted, endpoints require an API key presented in the X-API-Key header. The specification defines the APIKeyHeader security scheme.

Include your API key in requests using the X-API-Key header:

X-API-Key: <your-api-key>

Endpoints marked with Authentication: None are publicly accessible (for example, POST /accounts).

Response Envelope

Most JSON responses follow this envelope (streaming endpoints return SSE events instead):

{
  "success": true,
  "data": { ... },
  "message": "Operation successful",
  "timestamp": "2024-01-01T00:00:00Z"
}

Error responses set success to false and include an error payload with diagnostic context.