iblai-api-integration

# iblai-api-integration Manage an organization's account-level integrations via the API: connect the organization to external LLM providers, configure data source credentials, and issue Platform API tokens. Use when wiring an ibl.ai organization up to model providers or data sources, or issuing API keys. ## Auth & conventions - **Base URL:** `https://api.iblai.app` - **Header:** `Authorization: Api-Token $IBLAI_API_KEY` on every request. - **Path vars:** `{org}` = `$IBLAI_ORG`, `{username}` = `$IBLAI_USERNAME`. - Not connected yet? Run **`/iblai-api-login`** first to populate `IBLAI_ORG`, `IBLAI_USERNAME`, and `IBLAI_API_KEY`. ## Reads ### LLMs Third-party model provider keys. DM base: `/api/ai-account/…`. - **GET** `https://api.iblai.app/dm/api/ai-account/orgs/{org}/masked-llm-credential/` — list configured providers (masked). - **GET** `https://api.iblai.app/dm/api/ai-account/orgs/{org}/credential/schema/` — provider field schema. - **GET** `https://api.iblai.app/dm/api/ai-mentor/orgs/{org}/users/{username}/mentor/llms/` — available provider list. ### Data Sources Data source provider credentials. DM base: `/api/ai-account/…`. - **GET** `https://api.iblai.app/dm/api/ai-account/orgs/{org}/masked-integration-credential/` — list configured data sources (masked). - **GET** `https://api.iblai.app/dm/api/ai-account/orgs/{org}/integration-credential/schema/v2/[?name=]` — provider field schema. ### APIs Platform API keys. Same endpoints used to mint tokens elsewhere — see **`/iblai-api-token`** for the full reference. - **GET** `https://api.iblai.app/dm/api/core/platform/api-tokens/?platform_key={org}` — list tokens. ## Writes ### LLMs Third-party model provider keys. DM base: `/api/ai-account/…`. - **POST** `https://api.iblai.app/dm/api/ai-account/orgs/{org}/credential/` — add an LLM provider: ```json { "name": "provider, e.g. azure_openai (required)", "value": "object — provider fields (required)", "platform": "{org} (required)" } ``` - **DELETE** `https://api.iblai.app/dm/api/ai-account/orgs/{org}/credential/` — remove an LLM provider. Destructive — confirm with the user first. ```json { "name": "string (required)", "platform": "string (required)", "model_name": "string (optional, single Azure model)" } ``` ### Data Sources Data source provider credentials. DM base: `/api/ai-account/…`. - **POST** `https://api.iblai.app/dm/api/ai-account/orgs/{org}/integration-credential/` — add a data source: ```json { "name": "provider (required)", "value": "object (required)", "platform": "{org} (required)" } ``` - **DELETE** `https://api.iblai.app/dm/api/ai-account/orgs/{org}/integration-credential/` — remove a data source. Destructive — confirm with the user first. ```json { "platform": "string (required)", "name": "string (required)" } ``` ### APIs Platform API keys. Same endpoints used to mint tokens elsewhere — see **`/iblai-api-token`** for the full reference. - **POST** `https://api.iblai.app/dm/api/core/platform/api-tokens/` — create a token: ```json { "username": "string", "name": "string", "key": "", "platform_key": "string", "created": "string", "expires": "string", "expires_in": "string" } ``` - **DELETE** `https://api.iblai.app/dm/api/core/platform/api-tokens/{name}?platform_key={org}` — revoke a token. Destructive — confirm with the user first. ## Example Connect an Azure OpenAI provider to the organization: ```bash curl -X POST \ "https://api.iblai.app/dm/api/ai-account/orgs/$IBLAI_ORG/credential/" \ -H "Authorization: Api-Token $IBLAI_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "azure_openai", "value": { "api_key": "sk-...", "api_base": "https://my-resource.openai.azure.com", "api_version": "2024-02-15-preview" }, "platform": "'"$IBLAI_ORG"'" }' ``` ## Notes - LLMs and Data Sources are account-level — they apply to the whole organization, not a single agent. - List endpoints return **masked** credentials; fetch the matching `schema` endpoint to learn which fields a provider expects before POSTing. - The API-token endpoints are shared with `/iblai-api-token`; tokens created via either skill are the same Platform API tokens.