Publieke API
Coming soon
Deze documentatie beschrijft het geplande publieke API-model voor agents, skills, accounts, knowledge, cloud, policies, runs, automations, approvals en audit. De API is nog niet publiek beschikbaar; daarom staat ieder technisch onderdeel expliciet op coming soon.
Publieke API
Coming soon
OpenAPI spec
Coming soon
SDKs
Coming soon
De API wordt ontworpen rond hetzelfde objectmodel als het dashboard: organisatie, project, agent, skill, account, knowledge, policy, run en audit.
Toegang wordt project-scoped en policy-aware. API keys krijgen geen algemene organisatiebrede macht zonder expliciete scopes.
Iedere API-call wordt gekoppeld aan objecten die managers begrijpen en engineers kunnen automatiseren.
Runs worden zichtbaar als status, stappen, bronnen, approvals, artifacts en audit events. Automations zijn geplande runs met vaste instructies.
Webhooks komen voor statuswijzigingen, approvals, billing events, accountstatus, skill review en audit export.
De eerste publieke SDKs worden pas vrijgegeven nadat de API-contracten stabiel zijn en rate limits, errors en scopes vaststaan.
API Reference
Conceptuele V1-structuur. Paden, request bodies en response schemas worden pas definitief gepubliceerd na contracttests, rate limits en auth-scopes.
Projecten, contexten en dashboardgegevens beheren.
/v1/projectsProjecten binnen uw organisatie ophalen.
Coming soon/v1/projectsNieuw project of bedrijfscontext voorbereiden.
Coming soon/v1/projects/{projectId}Projectstatus, limits en configuratie lezen.
Coming soonAgent-instances samenstellen en activeren.
/v1/projects/{projectId}/agentsAgent-instances en readiness ophalen.
Coming soon/v1/projects/{projectId}/agentsAgent met skills, accounts en policies aanmaken.
Coming soon/v1/projects/{projectId}/agents/{agentId}Agent configuratie of status wijzigen.
Coming soonCurated en open-source skills ontdekken, beoordelen en installeren.
/v1/skillsSkillcatalogus met bron en reviewstatus ophalen.
Coming soon/v1/skills/{skillId}Requirements, policies en outputschema lezen.
Coming soon/v1/projects/{projectId}/skills/installSkill binnen projectscope installeren.
Coming soonAccounts, secrets en cloudomgevingen koppelen zonder plaintext terug te geven.
/v1/projects/{projectId}/accountsAccountkoppeling of secret-reference aanmaken.
Coming soon/v1/projects/{projectId}/accountsConfiguratiestatus en ontbrekende requirements ophalen.
Coming soon/v1/projects/{projectId}/cloudsAWS, Azure of Google Cloud context registreren.
Coming soonEenmalige of geplande uitvoering starten en volgen.
/v1/projects/{projectId}/runsAgent-run starten met input, policy en idempotency key.
Coming soon/v1/projects/{projectId}/runs/{runId}Status, stappen, output en artifacts ophalen.
Coming soon/v1/projects/{projectId}/automationsGeplande automation voorbereiden.
Coming soonControlelaag voor risicovolle acties en bewijsvoering.
/v1/projects/{projectId}/approvalsOpenstaande goedkeuringen ophalen.
Coming soon/v1/projects/{projectId}/approvals/{approvalId}/approveActie goedkeuren met actor en note.
Coming soon/v1/projects/{projectId}/auditAudit events filteren en exporteren.
Coming soonVoorbeeld
POST /v1/projects/{projectId}/runs
Authorization: Bearer oxiae_live_...
Idempotency-Key: run_...
{
"agent": "sales-development-agent",
"goal": "Vind 25 passende leads en maak een reviewrapport.",
"skills": ["firecrawl-search-scrape", "brave-web-search"],
"policy": "approval-required"
}Errors
| Status | Code | Betekenis | Status |
|---|---|---|---|
| 400 | invalid_request | Payload mist verplichte velden of gebruikt een onbekend object. | Coming soon |
| 401 | unauthorized | API key ontbreekt, is verlopen of is ingetrokken. | Coming soon |
| 403 | policy_denied | Scope, policy of projectgrens staat de actie niet toe. | Coming soon |
| 409 | approval_required | De actie kan pas door na menselijke goedkeuring. | Coming soon |
| 429 | rate_limited | Planlimiet, usagecap of burstlimiet bereikt. | Coming soon |
| 500 | runtime_error | Uitvoering kon niet veilig worden afgerond. | Coming soon |
Gebruik voorlopig het dashboard. Voor API-pilot toegang verzamelen we use cases, security-eisen en gewenste endpoints.