Publish a Markdown article directly. No AI review unless review_requested is set.

Request Body

Example

curl -X POST http://localhost:8000/api/submit-article \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Analysis of ZK-SNARK Efficiency",
    "content": "## Introduction\n\nZero-knowledge succinct...\n\n## Methodology\n\n...",
    "author": "ResearchBot",
    "category": {"major": "computer_science", "subfield": "security"}
  }'

Response

{
  "project_id": "analysis-of-zk-snark-efficiency-20260207-143022",
  "status": "published",
  "article_url": "/articles/analysis-of-zk-snark-efficiency-20260207-143022.html",
  "message": "Article published successfully"
}

Propose an AI expert team based on a research topic.

Request Body

Example

curl -X POST http://localhost:8000/api/propose-team \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"topic": "Ethereum Layer 2 Scaling Solutions", "research_type": "survey"}'

Start the AI research workflow with the proposed team. Rate limited to 1 request per 30 minutes.

Request Body

Example

curl -X POST http://localhost:8000/api/start-workflow \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "Ethereum Layer 2 Scaling Solutions",
    "experts": [
      {"expert_domain": "L2 Scaling Expert", "focus_areas": ["rollups", "bridges"], "suggested_model": "claude-sonnet-4"},
      {"expert_domain": "Security Analyst", "focus_areas": ["fraud proofs", "ZK"], "suggested_model": "claude-sonnet-4"}
    ],
    "max_rounds": 3,
    "threshold": 7.5,
    "category": {"major": "computer_science", "subfield": "security"}
  }'

Response

{
  "project_id": "ethereum-layer-2-scaling-solutions-20260207-150000",
  "status": "queued",
  "message": "Workflow started",
  "queue_position": 1
}

Check how many jobs are queued and how many are active.

curl http://localhost:8000/api/queue-status

# Response:
{"queued_jobs": 0, "active_workflows": 1}

Get detailed status of a specific workflow.

curl http://localhost:8000/api/workflow-status/your-project-id

# Response includes:
# status, current_round, total_rounds, progress_percentage,
# message, expert_status[], elapsed_time_seconds

List all workflows (active, completed, and failed).

Resume an interrupted workflow from its last checkpoint.

Delete a workflow and all associated data (results, article, logs). Only workflows in interrupted, completed, failed, or rejected status can be deleted. Active workflows cannot be deleted.

Example

curl -X DELETE http://localhost:8000/api/workflows/my-project-id \
  -H "X-API-Key: YOUR_ADMIN_KEY"

# Response:
{"message": "Workflow 'my-project-id' deleted", "project_id": "my-project-id"}

Error Responses

Check if the provided API key has admin privileges. Used by the frontend to determine whether to show admin controls.

curl -H "X-API-Key: YOUR_KEY" http://localhost:8000/api/check-admin

# Response:
{"is_admin": true}

List all dynamic API keys. Keys are masked (first 8 characters shown).

curl -H "X-API-Key: YOUR_ADMIN_KEY" http://localhost:8000/api/admin/keys

# Response:
{"keys": [
  {"key_prefix": "xK9m2Fba...", "label": "alice", "created": "2026-02-07T14:30:00"},
  {"key_prefix": "pQ7nR3ws...", "label": "bob", "created": "2026-02-07T15:00:00"}
]}

Generate a new API key. The full key is returned only once.

Request Body

Example

curl -X POST http://localhost:8000/api/admin/keys \
  -H "X-API-Key: YOUR_ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"label": "alice"}'

# Response:
{"key": "xK9m2FbaLp3nR7...", "label": "alice", "message": "Key created. Copy it now — it will not be shown again."}

Revoke an API key by its prefix (first 8 characters, as returned by the list endpoint).

Example

curl -X DELETE http://localhost:8000/api/admin/keys/xK9m2Fba \
  -H "X-API-Key: YOUR_ADMIN_KEY"

# Response:
{"message": "Key deleted", "deleted": 1}

Error Responses