Quick Reference

All important endpoints, parameters, and commands in one place

API Endpoints

POST /v1/chat/completionsChat — OpenAI-compatible
GET /v1/modelsList available models
POST /v1/embeddingsText embeddings
GET /v1/healthHealth check (no auth)
GET /.well-known/agent.jsonA2A Agent Card
GET /portal/api/compliance/reportCompliance report
GET /portal/api/otrs/dashboardOTRS live dashboard

Authentication

Authorization: Bearer {key}API key auth
Content-Type: application/jsonRequired for POST
curl https://api.iio.space/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"qwen2.5:7b","messages":[{"role":"user","content":"Hello"}]}'

Available Models

qwen2.5:7bFree · ~250ms · Best allround
llama3.2:3bPro · ~100ms · Fastest
mistral:7bPro · ~220ms · EU-origin
gemma2:9bPro · ~300ms · Good QA
llama3.1:70bEnterprise · ~800ms · Best quality

Python SDK

pip install iio-governance
pip install iio-governance[langchain]  # + LangChain

from iio_governance import (
    HITLGate, PolicyCheck,
    AuditTrail, ComplianceCheck
)

# HITL Gate
gate = HITLGate(api_url="https://api.iio.space")
result = gate.check("gate.production-deploy")
# result.status: "approved" | "pending" | "blocked"

# Policy
report = PolicyCheck(...).run()
# report.passed, report.failed, report.ok

# Compliance
cc = ComplianceCheck(...).check_eu_ai_act()
# cc.classification: "Limited Risk"

TypeScript SDK

npm install @iio/governance

import { HITLGate, PolicyCheck } from '@iio/governance';

const gate = new HITLGate({
  baseUrl: 'https://api.iio.space',
  apiKey: process.env.IIO_API_KEY!
});
const result = await gate.check('gate.production-deploy');
if (result.status !== 'approved') throw new Error('Gate blocked');

CLI Commands

iio gate check {gate-id}Check gate status
iio policy checkRun policy checks
iio policy check --format jsonJSON output
iio audit query --last 24hQuery audit events
iio compliance reportFull compliance report
iio models listList available models

IIO Operator Commands

session-start.shStart session (register scope)
session-closeout.shClose session (evidence)
policy-check.shRun 23 governance checks
agent-update-task.shUpdate task + scope
ops-fast-lane.sh doctorHealth check

HITL Gate IDs

gate.production-deployDeployment approval
gate.campaign-stage-advanceCampaign stage gate
gate.avv-signature-confirmContract signing
gate.developer-api-key-approveAPI key issuance
gate.content-publish-socialSocial media post
gate.customer-go-live-approveTenant onboarding
gate.minor-release-approveMinor release gate
gate.major-release-approveMajor release (dual)
Full API Docs · SDK Docs · Examples · Playground