AIOS API

Version 0.1.0 · Base URL https://aios.supply

The external AIOS API: lead capture, the embeddable agent widget, and CRM OAuth connect. Programmatic API-key access is on the roadmap and not yet live. Operators automate AIOS through the aios CLI and MCP server.

Machine-readable spec: /api-reference/openapi.json. Questions? Email [email protected].

post/api/lead

Capture a lead

Submit a lead (name, email, phone, message) into the connected CRM or AIOS native capture. Rate limited per IP.

Request

{
  "name": "Jane Roe",
  "email": "[email protected]",
  "phone": "+15555550123",
  "message": "Interested in a demo"
}

Response 200

{
  "ok": true
}
post/api/embed/agent

Send a message to an embedded agent

Backend for the embeddable chat widget. Sends a visitor message to the tenant's published agent and returns the reply. CORS-gated to the AIOS-served widget.

Request

{
  "tenant": "your-tenant",
  "messages": [
    {
      "role": "user",
      "content": "Do you do weekend appointments?"
    }
  ]
}

Response 200

{
  "reply": "Yes, we have Saturday slots. Want me to book one?"
}
get/api/connect/{provider}/start

Begin a CRM OAuth connection

Starts the one-click OAuth handshake for a connectable CRM. Redirects the signed-in user to the provider to approve AIOS. {provider} is the connector slug.

  • provider (path, required)

Response 200

{
  "redirect": "https://<provider>/oauth/authorize?..."
}
get/api/connect/{provider}/callback

Complete a CRM OAuth connection

OAuth redirect target. Exchanges the auth code, stores the connection credential in the vault (by reference, never plaintext), and binds it to the tenant.

  • provider (path, required)

Response 200

{
  "ok": true
}

Programmatic API-key access is on our roadmap and not yet live. Operators automate AIOS through the aios CLI and MCP server.