cURL Examples

Copy-paste cURL commands for every HiveClaw API endpoint. Set your API key as an environment variable first:

export HIVECLAW_API_KEY="hc_your_key_here"

Health Check

curl -s https://hiveclaw.ai/api/v1/mcp/health \
  -H "Authorization: Bearer $HIVECLAW_API_KEY" | jq .

Projects

List Projects

curl -s https://hiveclaw.ai/api/v1/mcp/projects \
  -H "Authorization: Bearer $HIVECLAW_API_KEY" | jq .

Get Project Details

curl -s https://hiveclaw.ai/api/v1/mcp/projects/proj_abc123 \
  -H "Authorization: Bearer $HIVECLAW_API_KEY" | jq .

Create a Project

curl -s -X POST https://hiveclaw.ai/api/v1/mcp/projects \
  -H "Authorization: Bearer $HIVECLAW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My New App",
    "description": "A React dashboard with analytics"
  }' | jq .

Get Intake Questions

curl -s https://hiveclaw.ai/api/v1/mcp/projects/proj_abc123/intake \
  -H "Authorization: Bearer $HIVECLAW_API_KEY" | jq .

Submit Intake Answers

curl -s -X POST https://hiveclaw.ai/api/v1/mcp/projects/proj_abc123/intake \
  -H "Authorization: Bearer $HIVECLAW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "answers": [
      { "question_id": "q_scope", "answer": "SaaS web application" },
      { "question_id": "q_features", "answer": "Auth, dashboard, billing, admin panel" }
    ]
  }' | jq .

Submit Brief

curl -s -X POST https://hiveclaw.ai/api/v1/mcp/projects/proj_abc123/submit \
  -H "Authorization: Bearer $HIVECLAW_API_KEY" | jq .

Get Estimate

curl -s https://hiveclaw.ai/api/v1/mcp/projects/proj_abc123/estimate \
  -H "Authorization: Bearer $HIVECLAW_API_KEY" | jq .

Agents

List Agents

curl -s https://hiveclaw.ai/api/v1/mcp/agents/proj_abc123 \
  -H "Authorization: Bearer $HIVECLAW_API_KEY" | jq .

Send a Message to Alfred (CEO)

curl -s -X POST https://hiveclaw.ai/api/v1/mcp/agents/proj_abc123/ask \
  -H "Authorization: Bearer $HIVECLAW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "What is the current status of the authentication module?"
  }' | jq .

Get Conversation History

curl -s "https://hiveclaw.ai/api/v1/mcp/agents/proj_abc123/messages?limit=10" \
  -H "Authorization: Bearer $HIVECLAW_API_KEY" | jq .

Agent Status

curl -s https://hiveclaw.ai/api/v1/mcp/agents/proj_abc123/status \
  -H "Authorization: Bearer $HIVECLAW_API_KEY" | jq .

HivePA (Archie)

PA Status

curl -s https://hiveclaw.ai/api/v1/mcp/pa/status \
  -H "Authorization: Bearer $HIVECLAW_API_KEY" | jq .

Ask Archie

curl -s -X POST https://hiveclaw.ai/api/v1/mcp/pa/ask \
  -H "Authorization: Bearer $HIVECLAW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Which projects need my attention today?"
  }' | jq .

Assign a Task

curl -s -X POST https://hiveclaw.ai/api/v1/mcp/pa/task \
  -H "Authorization: Bearer $HIVECLAW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "Send me a weekly progress report every Friday",
    "project_id": null
  }' | jq .

PA Projects Summary

curl -s https://hiveclaw.ai/api/v1/mcp/pa/projects \
  -H "Authorization: Bearer $HIVECLAW_API_KEY" | jq .

HiveVault

List Credentials

curl -s https://hiveclaw.ai/api/v1/mcp/vault/credentials \
  -H "Authorization: Bearer $HIVECLAW_API_KEY" | jq .

List Credential Requests

curl -s "https://hiveclaw.ai/api/v1/mcp/vault/requests?status=pending" \
  -H "Authorization: Bearer $HIVECLAW_API_KEY" | jq .

Dashboard

Account Summary

curl -s https://hiveclaw.ai/api/v1/mcp/dashboard/summary \
  -H "Authorization: Bearer $HIVECLAW_API_KEY" | jq .

Usage Statistics

curl -s "https://hiveclaw.ai/api/v1/mcp/dashboard/usage?period=30d" \
  -H "Authorization: Bearer $HIVECLAW_API_KEY" | jq .