API Reference

This document describes the current API routes implemented in ArchonHQ (src/app/api) for multi-agent workloads.

Authentication

NextAuth route handlers for Google OAuth session login.

Required env:

Forwards a GET request to:

{GATEWAY_URL}/{path}

Behavior:

Example:

/api/gateway/status -> ${GATEWAY_URL}/status

Returns all tasks ordered by createdAt.

Creates a task from JSON body.

Expected fields:

Updates a task by id with partial fields. Also updates updatedAt.

Deletes task by id.

SSE endpoint that publishes full task list snapshots every 5 seconds.

Headers:

Behavior:

Returns all .md files in WORKSPACE_PATH.

Returns raw file contents from WORKSPACE_PATH. Filename is sanitized via path.basename.

Writes markdown content to file.

Body:

{
  "name": "example.md",
  "content": "# Updated content"
}

Exchanges OAuth code and writes token JSON to a local config path.

Important:

This route currently uses hardcoded client credentials and redirect URI in source.
Treat this route as legacy/dev-only until refactored to env-driven config.