REST API

IO exposes a REST API on port 7777 (configurable). All endpoints return JSON.

Base URL

http://localhost:7777/api

Authentication

If Supabase is configured, requests must include a valid JWT:

Authorization: Bearer <supabase-jwt>

Without Supabase config, all endpoints are open.

---

Chat

Send Message

POST /api/chat
Content-Type: application/json

{
  "message": "What's the status of my squads?",
  "conversationId": "optional-existing-id",
  "source": "web"
}

Response: JSON with conversation and message data. Streaming happens via WebSocket (chat.stream_chunk events).

List Conversations

GET /api/conversations?limit=50&offset=0

Get Conversation

GET /api/conversations/:id

Delete Conversation

DELETE /api/conversations/:id

---

Squads

List Squads

GET /api/squads

Get Squad

GET /api/squads/:id

Create Squad (Hire)

POST /api/squads
Content-Type: application/json

{
  "repoUrl": "https://github.com/org/repo",
  "prMode": "draft-pr"
}

Update Squad

PUT /api/squads/:id
Content-Type: application/json

{
  "config": {
    "prMode": "ready-pr"
  }
}

Delete Squad (Fire)

DELETE /api/squads/:id

Get Squad Members

GET /api/squads/:id/members

Create Objective

POST /api/squads/:id/objectives
Content-Type: application/json

{
  "description": "Add dark mode support"
}

List Objectives

GET /api/squads/:id/objectives

---

Inbox

List Inbox Items

GET /api/inbox

Reply to Item

POST /api/inbox/:id/reply
Content-Type: application/json

{
  "message": "Approved, proceed with option A"
}

Mark as Read

PUT /api/inbox/:id/read

---

Schedules

List Schedules

GET /api/schedules

Create Schedule

POST /api/schedules
Content-Type: application/json

{
  "name": "Daily Standup",
  "cron": "0 9 * * *",
  "prompt": "Summarize yesterday's squad activity",
  "enabled": true
}

Update Schedule

PUT /api/schedules/:id
Content-Type: application/json

{
  "enabled": false
}

Delete Schedule

DELETE /api/schedules/:id

---

Wiki

List Pages

GET /api/wiki/pages

Get Page

GET /api/wiki/pages/:path

Create Page

POST /api/wiki/pages
Content-Type: application/json

{
  "path": "projects/my-app",
  "content": "# My App\n\nA React dashboard...",
  "tags": ["project", "react"]
}

Update Page

PUT /api/wiki/pages/:path
Content-Type: application/json

{
  "content": "# My App\n\nUpdated content...",
  "tags": ["project", "react"]
}

Delete Page

DELETE /api/wiki/pages/:path

Search Wiki

GET /api/wiki/search?q=typescript

---

Skills

List Skills

GET /api/skills

Install Skill

POST /api/skills/install
Content-Type: application/json

{
  "url": "https://github.com/user/repo/tree/main/skills/my-skill"
}

Remove Skill

DELETE /api/skills/:id

Discover Skills

GET /api/skills/discover

Note: This endpoint is a placeholder and currently returns an empty array.

---

Usage

Get Token Usage

GET /api/usage?from=2024-12-01&to=2024-12-31&squadId=optional

---

Activity

Get Activity Feed

GET /api/activity?limit=50&offset=0

---

Settings

Get Settings

GET /api/settings

Update Settings

PUT /api/settings
Content-Type: application/json

{
  "port": 7777,
  "logLevel": "debug"
}