Skip to main content
The Zo API lets you interact with your Zo from scripts, automations, or other apps. Authenticate with an API key from Settings > Developers.

​
Quick start

  1. Go to Settings > Developers and create an API key
  2. Copy it immediately — you won’t see it again
curl -X POST https://api.zo.computer/zo/ask \
  -H "Authorization: Bearer zo_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"input": "Hello, Zo!"}'

{
  "output": "Hello! How can I help you today?",
  "conversation_id": "conv_abc123"
}
Your API key grants full access to your Zo. Keep it secret and never commit it to version control.

​
API reference

Base URL: https://api.zo.computer
Send a message to your Zo and get a response.Request
{
  "input": "What's the weather like today?",
  "conversation_id": null,
  "model_name": null,
  "output_format": null,
  "stream": false
}
​
input
string
required
Your message to Zo
​
conversation_id
string
Continue an existing conversation
​
model_name
string
Override the default model
​
output_format
object
JSON Schema for structured output
​
stream
boolean
default:"false"
Enable streaming mode. Returns Server-Sent Events (SSE) instead of JSON.
Response
{
  "output": "I don't have access to real-time weather data, but I can help you check...",
  "conversation_id": "conv_abc123"
}
​
output
string | object
Zo’s response. Returns an object if output_format was specified.
​
conversation_id
string
ID to continue this conversation in subsequent requests.
Streaming Response (when stream: true)Returns a Server-Sent Events stream with Content-Type: text/event-stream. Each event has the format:
event: <EventType>
data: <JSON>
Event Types:
  • FrontendModelResponse — Text chunk from the model (data.content)
  • End — Stream completed (includes data.output if output_format was specified)
  • Error — Error occurred (data.message)
The x-conversation-id response header contains the conversation ID for follow-up requests.

​
Examples

​
Continuing a conversation

Use the returned conversation_id to continue the conversation: 
curl -X POST https://api.zo.computer/zo/ask \
  -H "Authorization: Bearer zo_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"input": "What did I just say?", "conversation_id": "conv_abc123"}'

​
Structured output

Use output_format to get responses as structured JSON. This is based on OpenAI’s Structured Outputs. 
curl -X POST https://api.zo.computer/zo/ask \
  -H "Authorization: Bearer zo_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "input": "List 3 programming languages and their main use cases",
    "output_format": {
      "type": "object",
      "properties": {
        "languages": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": { "type": "string" },
              "use_case": { "type": "string" }
            },
            "required": ["name", "use_case"]
          }
        }
      },
      "required": ["languages"]
    }
  }'

{
  "output": {
    "languages": [
      { "name": "Python", "use_case": "Data science and automation" },
      { "name": "JavaScript", "use_case": "Web development" },
      { "name": "Go", "use_case": "Backend services and infrastructure" }
    ]
  },
  "conversation_id": "conv_abc123"
}

​
Streaming

Use stream: true to receive responses as Server-Sent Events: 
import httpx
import json

with httpx.stream(
    "POST",
    "https://api.zo.computer/zo/ask",
    headers={
        "Authorization": "Bearer zo_sk_your_key_here",
        "Content-Type": "application/json"
    },
    json={"input": "Tell me a short story", "stream": True}
) as response:
    conv_id = response.headers.get("x-conversation-id")

    event_type = None
    for line in response.iter_lines():
        if line.startswith("event: "):
            event_type = line[7:]
        elif line.startswith("data: "):
            data = json.loads(line[6:])
            if event_type == "FrontendModelResponse":
                print(data.get("content", ""), end="", flush=True)
            elif event_type == "End":
                print()  # Newline at end